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NEW FEATURES AND DOCUMENTATION CHANGES Ree oh 


NEW FEATURES AND DOCUMENTATION CHANGES 


DO300 ALGOL - VERSION DOLLAR OPTION —- O4-2@3-73 


THIS PATCH IMPLEMENTS THE FOLLOWING ADDITIONAL SYNTAX FOR THE 
VERSION DOLLAR OPTION: 


<OPTION CONTROL CARD>: := 
$SET VERSION<VERSION INCREMENT>.<CYCLE INCREMENT><PATCH NUMBER> 


WHERE 
<VERSION INCREMENT>::= + <INTEGER> 
<CYCLE INCREMENT>::= + <INTEGER> 
<PATCH NUMBER>::= <EMPTY> / .<3 DIGIT INTEGER> 


IF VERSION INCREMENT AND CYCLE INCREMENT APPEAR ON THE VERSION CARD 
THEN THOSE INCREMENTS WILL BE ADDED TO THE VERSION ON THE SYMBOLIC. 
IF NO VERSION CARD APPEARS IN THE SYMBOLIC THE INCREMENTS VeBEUES 
WILL BE USED TO APPEND TO THE CARD IMAGES. 


IF THE PATCH NUMBER APPEARS ON THE VERSION CARD IT WILL UPDATE THE 
SYMBOLIC VERSION CARD. ALSO, THE PROGRAMMER CAN GAIN ACCESS TO ee 
PATCH NUMBER BY ACCESSING COMPILETIME (ee). 


(00326 ALGOL = STATISTICS IN ALGOL - 04-23-73 

A FEATURE FOR GATHERING TIMING STATISTICS HAS BEEN ADDED TO THE 
ALGOL LANGUAGE. IT PRODUCES OUTPUT SIMILAR TO THE STATISTICS 
PROCEDURES USED IN FORTRAN, BUT IS INVOKED BY A DOLLAR CARD OPTION 
CALLED STATISTICS. THE OPTION IS EXAMINED AT THE BEGINNING OF EACH 


e 
DO0326 ALGOL - STATISTICS IN ALGOL - 04-23-73 rauE 


PROCEDURE OR BLOCK. IF IT IS SET AT THAT TIME, STATISTICS ARE 
GATHERED FOR THAT PROCEDURE OR BLOCK. ALTHOUGH THE OPTION MAY BE 
ALTERED AT ANY TIME, ONLY ITS STATUS AT THE BEGINNING OF PROCEDURES 
AND BLOCKS IS SIGNIFICANT FOR DETERMINING WHETHER TIMINGS WILL BE 
MADE . 


IF STATISTICS ARE TAKEN FOR A’ PROCEDURE OR BLOCK, THEN THE 
FREQUENCY OF THAT PROCEDURE OR BLOCK IS MEASURED, ALONG WITH THE 
LENGTH OF TIME SPENT IN THAT PROCEDURE OR BLOCK. WHEN THE PROGRAM 
IS COMPLETED FOR ANY REASON CINCLUDING BOTH NORMAL EOJ AND DS-ING), 
THE STATISTICS GATHERED ARE PRINTED OUT ON THE DIAGNOSTIC FILE. 


ON THE OUTPUT LISTING, AN ASTERISK (*) INDICATES THAT THERE IS SOME 
DOUBT ABOUT THE TIMINGS FOR’ THE SPECIFIC PROCEDURE NAME WHICH 
PRECEDES THE ASTERISK. IN ADDITION, TIMINGS ARE INVALID FOR ANY 
PROCEDURE OR BLOCK WHICH IS ENTERED BY A BAD GO TO. 


FOR ANY PROCEDURE OR BLOCK WHICH HAS STATISTICS GATHERED , IT IS 
POSSIBLE TO BREAK DOWN THE TIMINGS TO THE LABEL LEVEL WITHIN THAT 
PROCEDURE BY SETTING THE OPTION LABELS. LABELS MUST APPEAR IN 
PARENTHESES IMMEDIATELY AFTER THE WORD STATISTICS ON THE DOLLAR 
CARD. IT MAY BE PRECEDED BY SET OR RESET. IF BOTH ARE OMITTED, 
SET IS ASSUMED. FOR EXAMPLE: 


S$ SET STATISTICS (LABELS) 
WILL BEGIN TIMING LABEL BREAKPOINTS. 
$ SET STATISTICS (RESET LABELS) 


WILL END TIMING OF LABEL BREAKPOINTS. SET OR RESET 
INSIDE THE PARENTHESES ONLY HAS EFFECT FOR THE DURATION 
OF THE PARENTHESES. 


ONLY THE FIRST SIX CHARACTERS OF ANY IDENTIFIER ARE PRINTED OUT IN 
STATISTICS LISTINGS. FOR FURTHER INFORMATION ABOUT THE FORM OF THE 
STATISTICS PRODUCED SEE FORTRAN NOTE 0DO0109 IN THE @.3. SYSTEM 
MISCE! LANEA. 
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THIS CHANGE ALLOWS THE PASSING OF A DIRECT ARRAY TO A NON-DIRECT 
FORMAL ARRAY. 


THIS CHANGE IMPLEMENTS A NEW SCARD OPTION, LISTINCL, WHICH CONTROLS 
THE LISTING OF CARDS FROM INCLUDED FILES. THOSE CARDS ARE NOW 
LISTED ONLY IF BOTH LIST AND LISTINCL ARE SET. LISTINCL IS RESET 
BY DEFAULT. 


Tats. CHANGE ALSO NOW SUPPRESSES A PAGE EJECT IF THE PAGE OPTION IS 
SET IN AN INCLUDE FILE BUT LIST AND LISTINCL ARE NOT BOTH SET. 


THIS CHANGE EXTENDS THE SYNTAX OF POINTER PRIMARIES AS FOLLOWS: 


1. THE CHARACTER SIZE IN A POINTER DESIGNATOR MAY NOW BE ZERO. 
IN THIS CASE, THE DESCRIPTOR WILL NOT BE CHANGED INTO A 
STRING DESCRIPTOR: IT WILL REMAIN A WORD-ORIENTED ARRAY 
DESCRIPTOR. 


2. A ONE-DIMENSIONAL ARRAY DESIGNATOR OR A FULLY SUBSCRIPTED 
VARIABLE MAY UNDER SOME CIRCUMSTANCES BE INTERPRETED AS A 
POINTER PRIMARY. THAT IS, THE "ARRAY PART" OF A POINTER 
DESIGNATOR MAY BE A POINTER PRIMARY WITHOUT BEING USED IN 
THE POINTER TRANSFER FUNCTION CONSTRUCT. THIS WILL HAPPEN 
WHENEVER CONTEXT DETERMINES THAT THERE IS NO CONFLICT WITH ~ 
OTHER LEGAL CONSTRUCTS, SUCH AS WHEN A POINTER EXPRESSION 
IS REQUIRED. IN THIS CASE, THE DESCRIPTOR REMAINS A WORD- 
ORIENTED DESCRIPTOR, AND IS NOT NECESSARILY INDEXED. THIS 
SYNTAX IS USEFUL FOR SUCH CONSTRUCTS AS: 


DO36e ALGOL — POINTER PRIMARIES —- 06-24-73 eae 


REPLACE A BY B FOR 10 WORDS 
WHERE A AND B ARE ONE-DIMENSIONAL ARRAYS. 


DOSES” =BRe>. Saber RELERENCE VOnTAeCe. 2 Uesui 2 

THIS CHANGE IMPLEMENTS THE "ARRAY REFERENCE VARIABLE". THE ARRAY 
REFERENCE VARIABLE IS USED AS A NORMAL ARRAY; HOWEVER, IT MAY REFER 
TO DIFFERENT ARRAYS AT DIFFERENT TIMES DURING EXECUTION OF A 
PROGRAM. | 


SYNTAX 


THE ARRAY REFERENCE VARIABLE IS DECLARED AS FOLLOWS: 


<ARRAY REFERENCE DECLARATION>::= <DIRECT SPEC> <TYPE> ARRAY 
REFERENCE <ARRAY REF LIST> 


WHERE 


<DIRECT SPEC>::= DIRECT / <EMPTY> 
<TYPE>: := INTEGER / REAL / ALPHA / BOOLEAN / DOUBLE / HEX / 
BCL / EBCDIC / ASCII / <EMPTY> 
<ARRAY REF LIST>::= <ARRAY REF> / <ARRAY REF LIST>, -<ARRAY REF > 
<ARRAY REF >::= <IDENTIFIER LIST>£<LOWER BOUND LIST>] 
<IDENTIFIER LIST>::= <IDENTIFIER> / <IDENTIFIER LIST>, 
<IDENTIFIERD> 
<LOWER BOUND LIST>::= <LOWER BOUND> / 
<LOWER BOUND LIST>,<LOWER BOUND> 
<LOWER BOUND>::= <INTEGER> 


THE ARRAY REFERENCE VARIABLE IS ASSIGNED A VALUE AS PORECHS: 
<ARRAY REF VARIABLE ID> := <ARRAY DESIGNATOR> 
SEMANTICS 


1. AN ARRAY REFERENCE VARIABLE IS NOT ITSELF AN ARRAY BUT 
CONTAINS A COPY DESCRIPTOR TO AN ARRAY. ANY REFERENCE TO 


DO364 ALGOL —- ARRAY REFERENCE VARIABLE - 05-07-73 peu oe 


AN ARRAY REFERENCE VARIABLE BEHAVES LIKE A REFERENCE TO 
THE ARRAY MOST RECENTLY ASSIGNED TO THE ARRAY REFERENCE 
VARIABLE. 


2. THE DIMENSION OF THE ARRAY REFERENCE VARIABLE IS 
DETERMINED BY THE NUMBER OF LOWER BOUNDS IN_- THE 
DECLARATION. THE ARRAY DESIGNATOR MUST HAVE THE SAME 
DIMENSION. 


3. THE TYPE OF THE ARRAY REFERENCE VARIABLE IS SPECIFIED IN 
THE DECLARATION; IF NO TYPE IS SPECIFIED, REAL IS ASSUMED. 
THE ARRAY DESIGNATOR ASSIGNED TO THE ARRAY REFERENCE 
VARIABLE MAY BE ANY TYPE. IF NECESSARY, THE COPY 
DESCRIPTOR WILL BE MODIFIED SO THAT IT AGREES WITH THE 
TYPE OF THE ARRAY REFERENCE VARIABLE. 


4. THE ARRAY REFERENCE VARIABLE MAY BE DECLARED DIRECT. IF 
SO, THEN ONLY DIRECT ARRAY DESIGNATORS MAY BE ASSIGNED TO 
Oa he HOWVER, NON-DIRECT ARRAY REFERENCE VARIABLES MAY BE 
ASSIGNED EITHER DIRECT OR NON-DIRECT ARRAY DESIGNATORS. 


5. THE LEX LEVEL OF THE ARRAY DESIGNATOR (1.E., THE LEVEL AT 
WHICH IT IS DECLARED) MAY NOT BE GREATER THAN THAT OF THE 
ARRAY REFERENCE VARIABLE; THAT 1S, THE ARRAY REFERENCE 
VARIABLE MAY NOT BE GLOBAL TO THE ARRAY DESIGNATOR. 


THIS CHANGE IMPLEMENTS A COMPILE-TIME FACILITY WHICH MAY BE USED 
CONDITIONALLY AND/OR ITERATIVELY TO COMPILE ALGOL SOURCE CODE. THE 
FACILITY CONSISTS OF (1) THE DECLARATION AND USE OF COMPILE-TIME 
VARIABLES; (2) COMPILE-TIME IDENTIFIER; (3) SEVERAL COMPILE-TIME 
STATEMENTS; AND (4) SOME NEW DOLLAR CARD OPTIONS. THE ALGOL 
COMPILER MUST BE COMPILED WITH THE DOLLAR OPTION CTPROC SET IN 
. ORDER. TO INCLUDE THESE FEATURES IN COMPILATIONS. 
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SYNTAX 

<COMPILE-TIME VARIABLE DECLARATION>::= NUMBER <CT VAR LIST> 

WHERE 

<CT VAR LIST>::= <CT VAR>D / <CT VAR LIST>,<CT VAR> 

<CT VAR>::= <IDENTIFIER> / <IDENTIFIER>:=<INITIAL VALUED / 
<IDENTIFIERSC<VECTOR LENGTH> ] 

<INITIAL VALUE>::= <ARITHMETIC EXPRESSION> 

<VECTOR LENGTH): := <ARITHMETIC EXPRESSION> 

SEMANTICS 


1. AN IDENTIFIER DECLARED TO BE A NUMBER IS A "NUMBER 
VARIABLE", OR AN ARITHMETIC COMPILE-TIME VARIABLE. 


2. A NUMBER VARIABLE REPRESENTS A SINGLE-PRECISION ARITHMETIC 


VALUE . IT MAY BE USED WHEREVER AN ARITHMETIC VALUE IS 
ALLOWED; IT REPRESENTS THE VALUE MOST RECENTLY ASSIGNED TO 
IT. 


3. THE VALUE OF A NUMBER VARIABLE MAY BE CHANGED AT ANY TIME 
DURING COMPILATION BY MEANS OF A COMPILE-TIME "LET" 
~ STATEMENT. 


4. A NUMBER VARIABLE MAY BE DECLARED WITH AN INITIAL VALUE. 
BY DEFAULT, THE INITIAL VALUE IS ZERO. THE INITIAL VALUE 
MUST BE A CONSTANT ARITHMETIC EXPRESSION. 


5. A VECTOR OF NUMBER VARIABLES MAY BE DECLARED BY SPECIFYING 
ITS LENGTH IN BRACKETS. THE MEMBERS OF A VECTOR OF NUMBER 
VARIABLES ARE REFERENCED LIKE SUBSCRIPTED VARIABLES. THE 
SUBSCRIPT MUST BE AN ARITHMETIC CONSTANT EXPRESSION, 
GREATER THAN OR EQUAL TO ZERO, AND LESS THAN THE DECLARED 
VECTOR LENGTH. THE VECTOR LENGTH MUST BE A CONSTANT 
ARITHMETIC EXPRESSION. 
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<COMPILE-TIME IDENTIFIER>::= <IDENTIFIER><APOSTROPHE ><NUMBERID> 
SEMANTICS 


1. A COMPILE-TIME IDENTIFIER IS FORMED BY COMBINING A 
COMPILE-TIME VARIABLE WITH AN IDENTIFIER. 


2. THE COMPILE-TIME IDENTIFIER MAY APPEAR ANYWHERE A NORMAL 
IDENTIFIER MAY BE USED, INCLUDING DECLARATIONS. 


3. NO. BLANK CHARACTERS MAY APPEAR BETWEEN THE IDENTIFIER AND 
THE APOSTROPHE . 


Wu. THE CREATED IDENTIFIER IS THE ORIGINAL IDENTIFIER FOLLOWED 
BY AN APSOTROPHE, FOLLOWED BY NUMERIC CHARACTERS 
CORRESPONDING TO THE VALUE OF THE COMPILE-TIME VARIABLE, 
WITH LEADING ZEROS SUPPRESSED. 


3. COMPILE-TIME STATEMENTS 
COMPILE-TIME STATEMENTS ARE INTRODUCED BY THE APOSTROPHE. 
THEY ARE RECOGNIZED AT A VERY PRIMITIVE LEVEL IN THE COMPILER 
AND MAY, THEREFORE, APPEAR "ALMOST ANYWHERE", SUCH AS BETWEEN 
ANY TWO NORMAL LANGUAGE ELEMENTS. 


THE COMPILE-TIME STATEMENTS ARE INTENDED TO PROVIDE A 
CONVENIENT METHOD FOR ALTERING THE NORMAL CONTROL OF 
COMPILATION, PRIMARILY VIA CONDITIONAL AND ITERATIVE 
COMPILATION. . 


THE COMPILE-TIME STATEMENTS (ALL INTRODUCED BY AN APOSTROPHE ) 
ARE: 


1. BEGIN 
see, LF 
3. THRU 
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4. FOR 

5. WHILE 
6. DEFINE 
7. INVOKE 
8. LET 


IN THE SYNTAX WHICH FOLLOWS, THE TERM "CTSTMT" REFERS TO ANY 
OF THESE STATEMENTS. THE TERM "TEXT" REFERS TO ANY ALGOL 
TEXT, INCLUDING COMPLETE COMPILE-TIME STATEMENTS. A QUOTE 
MARK (€") IS USED TO INDICATE AN APSOTROPHE. THIS IS FOR 
PRINTING REQUIREMENTS ONLY, AND THE APOSTROPHE IS THE ONLY 
CORRECT SYNTAX. 


COMPLETE COMPILE-TIME STATEMENTS ARE ALWAYS TERMINATED BY 
SEMICOLONS. HOWEVER, COMPILE-TIME STATEMENTS WHICH ARE 
COMPONENTS OF OTHER STATEMENTS MAY BE TERMINATED BY "END OR 
"ELSE. NOTE THAT THESE RULES ARE THE SAME AS FOR NORMAL 
ALGOL STATEMENTS. 


"BEGIN STATEMENT 


<COMPILE-TIME BEGIN STMT>::= "BEGIN<TEXT>"END<COMMENTS> 
SEMANTICS 


1. THIS STATEMENT DELIMITS A PORTION OF ALGOL TEXT. IT IS 
NORMALLY USED IN CONJUNCTION WITH THE "IF, “THRU AND "FOR 
STATEMENTS. 


e. IF THE STATEMENT IS NOT SKIPPED, THE ALGOL COMPILER 
PROCESSES ALL THE DELIMITED TEXT; OTHERWISE, THE COMPILER 
IGNORES THE TEXT. 


3. ANYTHING FOLLOWING THE "END UP TO THE FIRST SPECIAL 
CHARACTER, END, ELSE OR UNTIL IS CONSIDERED TO BE COMMENTS 
AND IS IGNORED. 
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Sala 

<COMPILE-TIME IF STMT>::= “IF <BOOLEAN EXPRESSION> THEN <CTSTMT> 
/ "IF <BOOLEAN EXPRESSION> THEN <CTSTMT> 
"ELSE <CTSTMT> 

SEMANTICS 


1. THIS STATEMENT PROVIDES FOR CONDITIONAL COMPILATION OF 
ALGOL TEXT. 


2. THE <BOOLEAN EXPRESSION> MUST BE A CONSTANT EXPRESSION. 
IF TRUE, THE <CTSTMT> FOLLOWING THEN IS PROCESSED. IF 
FALSE, THE <CTSTMT> FOLLOWING "ELSE IS PROCESSED, IF 
PRESENT. 


“THRU STATEMENT 


<COMPILE-TIME THRU STMT>::= "THRU <ARITHMETIC EXPRESSION> DO 
<CTSTMT > 
SEMANTICS 


1. THIS STATEMENT PROVIDES ITERATIVE COMPILATION OF ALGOL 
TEXT. 


2. THE <ARITHMETIC EXPRESSION> MUST BE A CONSTANT EXPRESSION, 
GREATER THAN OR EQUAL TO ZERO. 


3. THE <CTSTMT> FOLLOWING DO IS PROCESSED THE SPECIFIED 
“NUMBER OF TIMES. IF ZERO, THE STATEMENT IS SKIPPED. 


“FOR STATEMENT 
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ais 
<COMPILE-TIME FOR STMT>::= "FOR <NUMBERID>:=<AEXP-1> STEP 
<AEXP-2> 
UNTIL <AEXP-3> DO <CTSTMT> 
SEMANTICS 


1. THIS STATEMENT PROVIDES FOR ITERATIVE COMPILATION OF ALGOL 
TEXT. 


2. EACH AEXP MUST BE A CONSTANT ARITHMETIC EXPRESSION. AEXP- 
2 MAY BE POSITIVE OR NEGATIVE, BUT MUST NOT BE ZERO. 


3. THE ACTION OF THIS STATEMENT IS SIMILAR TO THE NORMAL 
ALGOL. FOR STATEMENT. AN EXCEPTION IS THAT AEXP-e AND 
AEXP-3 ARE EVALUATED ONLY ONCE, AT THE BEGINNING OF THE 
OPERATION. THEY ARE NOT REEVALUATED, EVEN THOUGH THEIR 
COMPONENTS MAY CHANGE VALUE. 


"WHILE STATEMENT 


Sek 

<COMPILE-TIME WHILE STMT>::= "WHILE <BOOLEAN EXPRESSION> DO 
-<CTSTMT> 

SEMANTICS 


Le THIS STATEMENTS PROVIDES FOR ITERATIVE COMPILATION OF 
ALGOL TEXT. 


2. THE <BOOLEAN EXPRESSION> MUST BE A CONSTANT EXPRESSION. 


3. PRIOR TO THE ITERATIONS, THE <BOOLEAN EXPRESSION> IS 
EVALUATED. IF IT IS TRUE, THE <CTSTMT> IS PROCESSED, IF 
IT IS FALSE, THE ENTIRE STATEMENT IS FINISHED. 


PAGE 


<COMPILE-TIME DEFINE STMT>::= "DEFINE <IDENTIFIER> = <CTSTMT> 
SEMANTICS 


Lee TALS STATEMENT DECLARES AN IDENTIFIER TO REPRESENT A 
<CTSTMT>. 


2. THE <CTSTMT> IS STORED AWAY, TO BE PROCESSED WHEN 
REFERENCED IN A SUBSEQUENT “INVOKE STATEMENT. 


"INVOKE STATEMENT 


<COMPILE-TIME INVOKE STMT>::= “INVOKE <IDENTIFIER> 
SEMANTICS | 


1. THIS STATEMENT CAUSES THE <CTSTMT>, PREVIOUSLY ASSOCIATED 
WITH THE IDENTIFIER IN A “DEFINE STATEMENT, TO BE 
PROCESSED. 


"LET STATEMENT 


oes 

<COMPILE-TIME LET STMT>::= "LET <NUMBER VARIABLE>:=<AEXP-2> 
WHERE | 

<NUMBER VARIABLE>::= <NUMBERID> / <NUMBERID>{AEXP-2] 
SEMANTICS 


1. THIS STATEMENT IS USED TO MODIFY THE VALUE OF A COMPILE- 
TIME VARIABLE. 


11 
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2. <AEXP-1> MUST BE A CONSTANT ARITHMETIC EXPRESSION. 


IF THE SUBSCRIPTED FORM IS USED, THE <NUMBERID> MUST HAVE 
BEEN DECLARED AS A VECTOR OF NUMBER VARIABLES; <AEXP-2> 
MUST BE GREATER THAN OR EQUAL TO ZERO AND LESS THAN THE 
DECLARED <VECTOR LENGTH>. 


4. NEW DOLLAR CARD OPTIONS 


1. CTMON 


IF CTMON IS SET, ALL ASSIGNMENTS TO COMPILE-TIME VARIABLES 
ARE MONITORED ON THE LINE PRINTER LISTING. 


2. CTLIST 


IF CTLIST IS SET, ALL CARD IMAGES PROCESSED ARE PRINTED ON 
THE LINE PRINTER LISTING. IN PARTICULAR, DURING ITERATIVE 
COMPILE-TIME STATEMENTS, CARD IMAGES WHICH ARE PROCESSED 
REPEATEDLY ARE PRINTED REPEATEDLY. THEY ARE IDENTIFIED BY 
AN ASTERISK (*) WHERE THE P OR C USUALLY APPEARS. IF 
CTLIST IS RESET (DEFAULT), CARD IMAGES ARE PRINTED ONLY 
THE FIRST TIME THEY ARE PROCESSED. 


3, LISTSKIP 


IF LISTSKIP IS RESET, THE PRINTING OF SKIPPED CARD IMAGES 
IS SUPPRESSED. IF LISTSKIP IS SET (DEFAULT), CARD IMAGES 
ARE PRINTED WHETHER OR NOT THEY ARE SKIPPED (PROVIDED 
OTHER LISTING OPTIONS ARE SET APPROPRIATELY) . 


4. LISTINCL 


IF LISINCL IS SET, CARD IMAGES FROM INCLUDE FILE ARE 
PRINTED ON THE LINE PRINTER LISTING (PROVIDED . OTHER 
LISTING OPTIONS ARE SET APPROPRIATELY). IF LISTINCL IS 
RESET (DEFAULT), INCLUDED CARDS ARE NOT PRINTED. 


5. CTTRACE 


IF CTTRACE IS SET, VALUES OF ALL EXPRESSIONS WHICH ARE 
COMPONENTS OF COMPILE-TIME STATEMENTS ARE PRINTED ON THE 
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LINE PRINTER LISTING. 


DO366 ALGOL - CLOSE WITH CRUNCH . - 07-14-73 


THIS PATCH ALLOWS A DISK FILE TO BE LOCKED WITH CRUNCH. THE SYNTAX 
REQUIRED IS 


CLOSE (F ILENAME , CRUNCH) 
OR 

LOCK (F ILENAME , CRUNCH) 
OR 

LOCK (F ILENAME, *) 


NOTE THAT THIS WILL ONLY HAVE AN EFFECT IF THE "CRUNCH" RUN-TIME 
SYSTEM OPTION IS SET. 


D0367 ALGOL = DOLLAR OPTION "INCLSEQ" = OV TlarTS 

THIS PATCH ADDS THE DOLLAR OPTION INCLSEQ. $SET INCLSEQ WILL 
RESEQUENCE AN INCLUDED FILE IF SEQ IS ALSO SET. IT IS NO LONGER 
NECESSARY TO SET NEWINCL IN ORDER TO RESEQUENCE AN INCLUDED FILE, 
HOWEVER, NEWINCL MUST STILL BE SET FOR AN INCLUDED FILE TO HAVE ITS 
CARD IMAGES IN THE NEWTAPE. | 


DO380 ALGOL - TASKF ILE HANDLING WITH CLOSE - 07-08-73 


THIS PATCH ALLOWS THE TASK ATTRIBUTE TASKFILE TO BE CLOSED USING 
THE CLOSE STATEMENT. ALSO, ANY BOOLEAN VALUED FILE ATTRIBUTE MAY 
NOW BE APPLIED TO TASKFILE, E.G., 


TASKID. TASKF ILE .OPEN 
IS NOW A LEGAL BOOLEAN EXPRESSION. 
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D0395 ALGOL —- MULTIPLE VALUE ARRAYS - 07-17-73 


DO395 ALGOL = MULTIPLE VALUE ARRAYS - 07-17-73 

THIS PATCH ALLOWS MULTIPLE VALUE ARRAY DECLARATIONS. PREVIOUSLY, 
ONLY ONE VALUE ARRAY COULD BE DECLARED IN A DECLARATION. NOW MORE 
THAN ONE VALUE ARRAY CAN BE DECLARED IN ONE DECLARATION. 


THE THRU STATEMENT HAS HAD ITS RANGE EXTENDED. IT MAY NOW BE 
EXECUTED FROM 0 TO 2*38 -1 TIMES. 


DUIUL. BECO. “AOekeoe: EQUATION “2 ui-ar 

THIS PATCH ALLOWS ADDRESS EQUATION AMONG INTEGER, REAL, AND BOOLEAN 
VARIABLES. SECTION 10.4 OF THE B6700/B7700 EXTENDED ALGOL LANGUAGE 
INFORMATION MANUAL SHOULD BE CHANGED TO THE FOLLOWING: 


10.4 TYPE DECLARATION 


ena elas 

<TYPE DECLARATION>::= <LOCAL OR OWN TYPE><IDENTIFIER LIST> / 
<SIMPLE TYPE><EQUATION LIST> 

<LOCAL OR OWN TYPE>::= <TYPE> / OWN<TYPE> 


<TYPE>::=<SIMPLE TYPE> / DOUBLE / ALPHA 

<SIMPLE TYPE>: :=REAL/ INTEGER/BOOLEAN 

<EQUATION LIST>::= <IDENTIFIER>=<IDENTIFIER> / <IDENTIFIER LIST> /. 
<EQUATION LIST>,<IDENTIFIER>=<IDENTIFIER> / 
<EQUATION LIST>,<IDENTIFIER> 

<IDENTIFIER LIST>::= <IDENTIFIER> / <IDENTIFIER LIST>,<IDENTIFIER> 
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THIS PART REMAINS THE SAME AS IN THE MANUAL. 
10.40 THE EQUATION LIST - 


THE <EQUATION LIST> ALLOWS ADDRESS EQUATION AMONG REAL, INTEGER, 
AND BOOLEAN VARIABLES ONLY. AN <IDENTIFIER> MAY ONLY BE ADDRESS 
EQUATED TO A PREVIOUSLY DECLARED LOCAL <IDENTIFIER> OR TO AN. 
<IDENTIFIER> GLOBAL TO THE BLOCK IN WHICH IT IS DECLARED. 


ae ee —-— ee ae ee Oe eee ee 


THIS PATCH NOW ALLOWS THE FOLLOWING OPERATORS TO BE USED IN ALGOL: 


>= FOR GEQ 
<= FOR LEQ 
“t= FOR NEQ 

FOR OR 


DOYOS ALGOL - CONTINUE STATEMENT SYNTAX gp bars nee 


THE SYNTAX FOR A <CONTINUE STATEMENT> IN SYSTEM MISCELLANEA, DATED 
11 APRIL 1973, PAGES 6-1le, 6-13, SHOULD BE CHANGED FROM 


CONTINUE [<TASK DESIGNATOR> ] 
- TO 
CONTINUE (<TASK DESIGNATOR>) 


ALSO THE EXAMPLE ON PAGE 9-39 OF THE 06-72 ALGOL LANGUAGE MANUAL 
SHOULD BE CHANGED FROM 


CONTINUE [T); 
TO 
CONTINUE (T): 


P 
DOYYO ALGOL - INITIALIZATION —- 07-23-73 AGE Ee 


pou4o = ALGOL.s = «INITIALIZATION = O77e3-73 

THE DEFAULT ERROR LIMIT ASSIGNED BY THE ALGOL COMPILER FOR USE 
UNDER CANDE WAS SET TO 10 BUT WAS THEN REASSIGNED TO 150 IN THE 
INITIALIZATION OF THE COMPILER. THIS PATCH SETS THE ERROR LIMIT 
FOR CANDE USE TO 10 AND DOES NOT OVERRIDE THIS ASSIGNMENT AS 
PREVIOUSLY DONE. 


DOU] ALGOL - CASE STMT AND NUMBERED STMTS - 07-29-73 


THE CASE STATEMENT SYNTAX AND SEMANTICS FOUND ON PAGE 9-5 OF THE 
ALGOL LANGUAGE MANUAL IS MODIFIED AS FOLLOWS: 


SUNT Re 
<CASE STATEMENT>::= CASE <ARITHMETIC EXPRESSION> OF <CASE BODY> 
<CASE BODY>::= <COMPOUND TAIL> / 
BEGIN <NUMBERED STATEMENT LIST> END 
<NUMBERED STATEMENT LIST>::= <NUMBERED STATEMENT GROUP> / 
<NUMBERED STATEMENT GROUP> ; <NUMBERED 
STATEMENT LIST> 
<NUMBERED STATEMENT GROUP>::= <UNSIGNED INTEGER>:<STMT LIST> 
<STMT LIST>::= <STATEMENT> / <STMT LIST>;<STATEMENT > 
SEMANTICS: 


CASE STATEMENTS PROVIDE A CONVENIENT MEANS OF DYNAMICALLY SELECTING 
ONE OF MANY ALTERNATIVE SECTIONS OF CODE FOR EXECUTION AT A. 
PARTICULAR POINT IN THE PROCESSING OF A PROGRAM. THE CODE IS 
SELECTED DIFFERENTLY FOR THE TWO TYPES OF <CASE BODY>S. 


<COMPOUND TAIL>: 

A <COMPOUND TAIL> IS A’ LIST OF <STATEMENT>S SEPARATED BY 
SEMICOLONS, BRACKETED BY A BEGIN AND END. THESE <STATEMENT>S 
MAY BE NUMBERED ZERO THROUGH WN. IF THE RESULT OF THE 


DOY4Y1 ALGOL - CASE STMT AND NUMBERED STMTS” - 07-29-73" AE 


<ARITHMETIC EXPRESSION> IS M, THEN M IS INTEGERIZED IF 


NECESSARY. IF M IS LESS THAN ZERO OR GREATER THAN N (THE 


NUMBER OF STATEMENTS LISTED IN THE <COMPOUND TAIL>, THEN AN 
INVALID INDEX INTERRUPT IS GENERATED. AFTER EXECUTION OF THE 
MTH STATEMENT, A BRANCH IS PERFORMED TO THE NEXT <STATEMENT> 
FOLLOWING THE <CASE STATEMENT>. NOTE THAT EVEN THOUGH 
SYNTACTICALLY THE <CASE BODY> APPEARS TO BE A <COMPOUND 
TAIL>, SEMANTICALLY IT IS ABOUT AS FAR REMOVED FROM A 
<COMPOUND TAIL> AS ONE COULD IMAGINE. 


NUMBERED STATEMENTS: 
THIS) ALTERNATIVE FORM OF THE <CASE STATEMENT> FUNCTIONS 
SIMILARLY TO THE FORM DESCRIBED ABOVE. THE MAJOR DIFFERENCE 
IS THAT RATHER THAN IMPLICITLY NUMBER THE <STATEMENT>S IN THE 
<COMPOUND TAIL> AS THEY APPEAR, THE USER IS REQUIRED TO 
EXPLICITLY NUMBER THE STATEMENT GROUPS. LET A REPRESENT THE 
LOWEST NUMBER ASSIGNED TO A STATEMENT LIST, AND B THE HIGHEST 
VALUE ASSIGNED. A AND B MUST BE NON-NEGATIVE. THE | 
INTEGERIZED VALUE OF THE <ARITHMETIC EXPRESSIOND>D (CALL IT M) 
MUST FULFILL THE REQUIREMENTS A LEQ M LEQ B. IF THIS IS NOT 
SO, AN ERROR WILL BE SIGNALED. FURTHERMORE, M MAY NOT TAKE 
ON ANY VALUES THAT WERE NOT ASSOCIATED WITH SOME <STATEMENT 
LIST>. AT THE END OF EACH <NUMBERED STATEMENT GROUP> A 
BRANCH IS GENERATED TO THE <STATEMENT> FOLLOWING THE <CASE 
STATEMENT>. 


EXAMPLES: 
CASE I OF 
BEGIN 

:=1; 
J:=20; 
J:=3; 
J:=4; 

END; 
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DOYW4 1 ALGOL - CASE STMT AND NUMBERED STMTS - 07-29-73 


11: J:=li; 1I:=e0; 
Q:=Q+1; X:=0; 


GO TO EXIT; 
le: J:=12; 

X:=X+13 
13: X:=14; 
15: X:=20; Q:=Qt1; 


END; 


THIS PATCH ADDS NORMALIZE TO THE LIST OF ARITHMETIC FUNCTIONS 
INTRINSIC TO ALGOL. 


SYNTAX: 


<NORMALIZE FUNCTION>::= NORMALIZE (<ARITHMETIC EXPRESSION) ) 
SEMANTICS: 


THE NORMALIZE FUNCTION NORMALIZES ITS ARGUMENT, I.£., EMITS A SNGL 
OPERATOR, RETURNING A SINGLE PRECISION RESULT. 


DOWYS = ALGOL = SINGLE SPACE DEFAULT = 08-19-73 


THIS PATCH MAKES THE LINE PRINTER DEFAULT SPACING FOR ALGOL SINGLE 
SPACED RATHER THAN DOUBLE SPACED. A COMPILE TIME OPTION HAS BEEN 
ADDED FOR INSTALLATIONS WHICH PREFER DEFAULT DOUBLE SPACING. THIS 
COMPILE TIME OPTION IS DOUBLESPACE. DOUBLESPACE MUST BE SET DURING 
COMPILATION OF THE COMPILER IN ORDER TO GET DOUBLE SPACE DEFAULT, 
OTHERWISE, SINGLE SPACING WILL BE THE DEFAULT. 


DOYYY ALGOL - CRUNCH NEW SYMBOL FILES - 09-04-73 EAE 272 


THIS PATCH CAUSES NEW SYMBOL FILES TO BE CRUNCHED WHEN THE "NEW" 
OPTION IS SET. , 


DOYB9 = ALGOL = SEPCOMP - 05-19-73 

AN AUTOMATIC SEPARATE COMPILATION AND BINDING FACILITY IS AVAILABLE 
IN THE 2.5 ALGOL (AND DCALGOL) COMPILER. THIS FACILITY. IS 
PARTICULARLY HELPFUL FOR DEVELOPMENT WORK ON LARGE ALGOL PROGRAMS, 
SINCE THE AMOUNT OF CONTROL INFORMATION REQUIRED BY THE COMPILER TO 
REPLACE PROCEDURES IN HOST PROGRAMS HAS BEEN REDUCED TO A MINIMUM. 
THIS FACILITY IS INTENDED AS A SUPPLEMENT TO, NOT A REPLACEMENT 
FOR, OTHER METHODS OF COMPILING AND’ BINDING ALGOL PROCEDURES. 
GIVEN ONLY THE NAME OF THE HOST PROGRAM TO BE CHANGED, AND THE 
PATCHES TO CHANGE IT, THE COMPILER IS ABLE TO SEPARATELY COMPILE 
AND BIND TO THE HOST ONLY THOSE PROCEDURES WHICH ARE BEING CHANGED. 
THIS METHOD REQUIRES THAT CERTAIN INFORMATION BE ASSOCIATED WITH 
THE HOST PROGRAM, INFORMATION THAT IS NOT NORMALLY COLLECTED AND 
SAVED DURING THE COMPILATION OF A PROGRAM. 


"MAKEHOST" IS THE DOLLAR OPTION THAT REQUESTS THAT THIS INFORMATION 
BE SAVED WHEN COMPILING A BLOCK PROGRAM OR PROCEDURE AT LEVEL TWO. 
THIS OPTION CANNOT BE EXPLICITLY REFERENCED AFTER THE APPEARENCE OF 
THE FIRST SYNTACTICAL ITEM. 


IF MAKEHOST IS SET, INFORMATION IS SAVED IN THE CODE FILE OF THE 
PROGRAM ABOUT THE SYMBOLIC FILE USED OR CREATED BY THE COMPILATION, 
THE SEQUENCE RANGES OF ALL PROCEDURE BODIES DECLARED IN THE OUTER 
BLOCK OF THE PROGRAM, AND THE DECLARATIVE ENVIRONMENT OF THE OUTER 
BLOCK. THE ENVIRONMENT OF THE OUTER BLOCK IS SIMILAR TO THE 
INFORMATION OBTAINED BY THE “DUMPINFO" DOLLAR OPTION, AND ENABLES 
LEVEL THREE PROCEDURES TO BE COMPILED SEPARATELY WITHIN THIS 
ENVIRONMENT. 


ADDITIONAL ENVIRONMENTS MAY BE SAVED, IF DESIRED, IN ORDER THAT 
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PROCEDURES AT LEVELS GREATER THAN THREE MAY BE REPLACED. 
ADDITIONAL ENVIRONMENTS CAN ONLY BE SPECIFIED IMMEDIATELY FOLLOWING 
THE SETTING OF THE MAKEHOST OPTION. 


Sunless 
<ADDITIONAL-ENVIRONMENT>::= <EMPTY> / (<ENVIRONMENT-LIST>) 
<ENVIRONMENT-LIST>::= <ENVIRONMENT> / <ENVIRONMENT-LIST>, 
<ENV IRONMENT > 
<ENVIRONMENT>::= <PROCEDURE-IDENTIFIER> / <PROCEDURE-IDENTIFIER> OF 
<ENV I RONMENT > . 


EXAMPLE 
§ SET MAKEHOST 
§ SET MAKEHOST (PASSONE, PASSTWO) 
§ SET MAKEHOST (PASSONE, PASSTWO, WRAPUP OF PASSTWO) 


IN THE EXAMPLE, THE LAST DOLLAR CARD OVERRIDES THE FIRST TWO, 
SAVING THE ENVIRONMENTS OF PASSONE, PASSTWO AND WRAPUP OF PASSTWO 
IN ADDITION TO THE ENVIRONMENT OF THE OUTER BLOCK. THE 
<ENVIRONMENT-LIST> MAY EXTEND ACROSS SEVERAL CARD IMAGES, A 
PRECEDENT ARISING MORE OUT OF NECESSITY THAN DESIRE. THE CURRENT 
IMPLEMENTATION, FOR REASONS OF SIMPLICITY, REQUIRES ENVIRONMENTS TO 
BE FULLY QUALIFIED THROUGH LEVEL THREE PROCEDURE IDENTIFIERS. IF 
AN ENVIRONMENT IS NEVER FOUND DURING THE COURSE OF COMPILATION, THE 
COMPILER LISTS THE UNKNOWN ENVIRONMENT, ALONG WITH A SYNTAX ERROR. 
ENVIRONMENTS MAY APPEAR IN ANY ORDER, WITHOUT REGARD TO THE ACTUAL 
BLOCK STRUCTURE OF THE HOST PROGRAM. 


FINALLY, WHEN MAKING A HOST, DO NOT FORGET TO SET THE “NEW" DOLLAR 
OPTION IF THERE ARE ANY CHANGES TO THE HOST. THE DEFAULT SYMBOLIC 
FILE ASSOCIATED WITH THE HOST IS THE TITLE OF THE "NEWTAPE" FILE IF 
ONE HAS BEEN CREATED, OTHERWISE IT IS THE TITLE OF THE "TAPE" FILE. 


"SEPCOMP" IS THE DOLLAR OPTION THAT INVOKES THE AUTOMATIC SEPARATE 
COMPILATION AND BINDING FACILITY. AS A DOLLAR OPTION, SEPCOMP HAS 
SOME PECULIAR DISTINCTIONS. IT CANNOT BE EXPLICITLY REFERENCED 
AFTER THE BEGINNING OF THE COMPILATION NOR ARE MULTIPLE SEPCOMP 


DO4S9 ALGOL - SEPCOMP - 05-19-73 RAGE 


OPTION SETTINGS ALLOWED SINCE, WHEN FIRST SET, IT INITIATES THE 
PREPROCESSING OF THE CARD FILE INPUT. THE TITLE OF THE HOST 
PROGRAM CAN BE SPECIFIED EITHER AS A STRING IMMEDIATELY FOLLOWING 
THE WORD SEPCOMP ON THE DOLLAR CARD OR BY LABEL EQUATING THE ALGOL 
COMPILERS FILE HOST. THE OPTIONAL STRING SPECIFICATION HAS 
PRECEDENCE OVER LABEL EQUATION. THESE TWO COMPILE DECKS BOTH 
SPECIFY A HOST FILE TITLED "A/HOST". 


DECK 1: 


?COMPILE A/B WITH ALGOL FOR LIBRARY 
?DATA , 

$ SEPCOMP "“A/HOST" LIST STACK 

$ SET LINEINFO 

% PATCH CARD <SEQ-NUMBER > 
?END 


DECK @: 


?COMPILE A/B WITH ALGOL FOR LIBRARY 
?ALGOL FILE HOST=A/HOST 
?DATA 
$ SEPCOMP LIST STACK 
$ SET LISTDELETED 

% PATCH CARD <SEQ-NUMBER> 
?END 


ONCE THE HOST FILE TITLE %1IS KNOWN, THERE IS NOTHING ELSE TO DO 
EXCEPT PROVIDE THE PATCH CARDS. DOLLAR CARDS WITH BLANK SEQUENCE 
NUMBERS ARE ACCEPTED FOLLOWING THE DOLLAR CARD SETTING THE SEPCOMP 
OPTION AND PRIOR’ TO THE FIRST "PATCH CARD". A "PATCH CARD" IS A 
CARD HAVING A NON-BLANK SEQUENCE NUMBER AND AT LEAST ONE IS 
REQUIRED. AMONG PATCH CARDS HAVING NON-BLANK SEQUENCE NUMBERS, 
SEQUENCE ERRORS ARE NOT ALLOWED. SEPCOMP LOOKS AT THESE PATCH 
CARDS, DECIDES WHICH PROCEDURES CAN BE COMPILED, AND TAKES CARE OF 
GENERATING BINDER CONTROL iNFORMATION FOR REPLACING THESE 

PROCEDURES IN THE HOST. SEPCOMP ALWAYS TRIES TO COMPILE PROCEDURES 
AT THE HIGHEST POSSIBLE LEX LEVEL. THEREFORE, THE NUMBER OF EXTRA 
ENVIRONMENTS SPECIFIED WHEN MAKING A HOST HAS AN EFFECT ON CHOICES 
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AVAILABLE TO SEPCOMP. 


SEPCOMP SETS SEVERAL OTHER DOLLAR OPTIONS AUTOMATICALLY IN AN 
EFFORT TO SIMPLIFY OPERATION. THE MERGE OPTION IS UNAVAILABLE FOR 
USE DURING SEPCOMP CONTROL. REFERENCES TO THIS OPTION ARE IGNORED 
AFTER SEPCOMP HAS BEEN SET. SETTING MERGE PRIOR TO SETTING SEPCOMP 
IS ILLEGAL SINCE IT DESTROYS THE DEFAULT LABEL EQUATION OF THE 
SYMBOLIC FILE TO BE MERGED WITH THE PATCHES. THE TITLE OF THE 
DEFAULT SYMBOLIC FILE IS ASSOCIATED WITH THE HOST, BUT THIS TITLE 
CAN BE OVERRIDDEN BY LABEL EQUATION OF THE ALGOL FILE TAPE. 
SEPCOMP SETS BOTH THE "AUTOBIND" AND "LIBRARY" OPTIONS CAUSING ALL 
PROCEDURES TO BE COMPILED INTO ONE MULTI-PROGRAM CODE FILE, A 
TEMPORARY FILE LEFT OPEN FOR THE USE OF THE BINDER. EXPLICITLY 
RESETTING “AUTOBIND" WILL PREVENT THE BINDER FROM BEING CALLED AND 
RESULT IN THE CODE FILE BEING LOCKED ON DISK IF COMPILED FOR 
LIBRARY. EXPLICITLY RESETTING "LIBRARY" WILL CAUSE EACH PROCEDURE 
COMPILED TO BE PUT IN A SEPARATE AND PERMANENT CODE FILE. BINDING 
MAY STILL OCCUR, BUT AT A SOMEWHAT SLOWER RATE. IF PROCEDURES ARE 
PUT IN SEPARATE CODE FILES, THE TITLE OF THE CODE FILE IS 
DETERMINED IN THE STANDARD WAY, WITH THE PROCEDURE NAME REPLACING 
THE LAST IDENTIFIER FROM THE TITLE ON THE COMPILE CARD. PROCEDURES 
COMPILED AT LEX LEVEL FOUR AND HIGHER HAVE THE NAME OF THEIR 
ENVIRONMENT USED IN THE CODE FILE NAME ALSO. FOR EXAMPLE, IF WE 
COMPILED TWO LEVEL FOUR PROCEDURES HAVING THE SAME NAME BUT 
DIFFERENT ENVIRONMENTS AS: 


? COMPILE A/HOST WITH ALGOL FOR LIBRARY 
2? DATA 

$ SEPCOMP "A/HOST" 

$ RESET LIBRARY 


% PATCH CARD TO Q OF PASSONE <SEQ-NUMBER> 
% PATCH CARD TO Q.OF PASSTWO <SEQ-NUMBER> 
?END 


TWO CODE FILES WOULD BE PRODUCED, A/PASSONE/Q AND A/PASSTWO/Q, IN 
ADDITION TO THE NEW HOST FILE "A/HOST" ASSUMING PASSONE AND PASSTWO 
WERE SPECIFIED AS EXTRA ENVIRONMENTS WHEN "A/HOST" WAS MADE. 
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THE SPECIAL INFORMATION ASSOCIATED WITH THE HOST PROGRAM IS ALWAYS 
COPIED OVER BY THE BINDER TO THE CODE FILE OF THE NEW PROGRAM SO IT 
ALSO MAY BE USED AS A_ HOST, AS IN THE PREVIOUS EXAMPLE. THIS 
INFORMATION IS NOT, HOWEVER, "UPDATED" EITHER BY THE BINDER OR THE 
COMPILER DURING THE SEPCOMP PROCESS AND IT IS POSSIBLE FOR THIS 
INFORMATION TO COME TO INACCURATELY REFLECT THE ACTUAL STRUCTURE 
AND CONTENT OF THE HOST PROGRAM WITH WHICH IT IS ASSOCIATED. 


BECAUSE OF THE ORDER OF THE CODE FILE IT IS MUCH FASTER TO BIND TO 
A BOUND HOST THAN TO AN UNBOUND HOST. FOR THIS REASON, IT MAY BE 
ADVANTAGEOUS TO SET AUTOBIND WHEN COMPILING A HOST PROGRAM JUST TO 
GET THE BINDER TO REARRANGE THE CODE FILE. 


WHEN COMPILING MULTIPLE PROCEDURES, SUCH AS THE ALGOL INTRINSICS, 
IT IS NOW MORE EFFICIENT TO SET THE DOLLAR OPTION "LIBRARY". THIS 
WILL CAUSE ALL OBJEPP->T:4TAM CODE TO BE PUT IN ONE FILE AND MARKED 
AS A MULTI-PROCEDURE CODE FILE. BINDER CONTROL CARDS FOR BINDING 
THESE PROCEDURE, EITHER TO A HOST OR AN INTRINSIC FILE, WILL HAVE 
TO BE CHANGED, HOWEVER. IF, FOR EXAMPLE,. SOME PROCEDURES WERE 
COMPILED AS "A/B", THEN THE BIND CARD WOULD HAVE TO BE CHANGED: 


FROM: BIND = FROM A/=; 
TO: BIND = FROM A/B; 


THE LIBRARY OPTION IS INITIALIZED TO TRUE WHEN COMPILING FROM CANDE 
OR WHEN USING THE "SEPCOMP" FACILITY. 
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NEW FEATURES AND DOCUMENTATION CHANGES 


BACKUP 


THIS CHANGE ALLOWS THE USER TO SPECIFY A FILE NAME TO BACKUP. THE 
SYNTAX IN THE I1.4 SYSTEM MISCELLANEA ON PAGE 8-3 SHOULD READ: 


<INPUT DESIGNATOR>::= MT<UNIT NO.> / D<MIX NO.> / 
D<PB FILE ID> / “<FILE NAME>" 


SPECIFYING THE FILE NAME IS USEFUL WHEN PRINTING A FILE WHICH WAS 
CREATED USING THE BDNAME AND BDBASE OPTIONS WHICH WILL HAVE A FILE 
NAME OF <NAME FROM BDNAME>/<MIX NO.>/<INTERNAL FILE NAME> AND 
CANNOT NORMALLY BE PRINTED BY BACKUP UNLESS THE NAME IS CHANGED. 


EXAMPLES: 
IF THE FOLLOWING JOB WERE RUN: 


<I1>COMPILE A/B ALGOL 
<1 >ALGOL OPT ION=BDBASE . 
<1 >BDNAME=LISTING 


<I>END JOB 


AND HAD A MIX NUMBER OF 670, THE BACKUP FILE CONTAINING THE 
LISTING WOULD HAVE THE TITLE LISTING/OOOO670/000LINE, IT 
COULD BE PRINTED BY: 


<I>PB "LISTING/O000670/000LINE" 


OTHER OPTIONS, SUCH AS SAVE, KEY, RANGE, ETC COULD ALSO BE 
USED, IF DESIRED. 


IF THE FOLLOWING JOB WERE RUN: 


D0288 BACKUP - SPECIFIC FILE NAMES - 04-23-73 PASE © 


<I>RUN A/B 
<1 >OPT ION=BDBASE 
< 1 >BDNAME =MYNAME 
<1>END JOB 


AND A/B- INTERNALLY USED A PRINTER FILE CALLED PRNT, AND WAS 
RUN WITH A MIX NUMBER OF 1234, THE BACKUP FILE WOULD HAVE THE 
TITLE MYNAME/0001234/000PRINT. IT COULD BE PRINTED BY: 


<1>PB "MYNAME/0001234/000PRNT" 


IF A DIRECTORY NAME IS SPECIFIED (E.G., <1>PB "MYNAME"), ALL 
BACKUP FILES UNDER THE DIRECTORY WILL BE PRINTED AND/OR 
PUNCHED. 


SYSTEM/BACKUP NOW GIVES THE OPERATOR THE OPTION TO CONTINUE AFTER 
AN IRRECOVERABLE PARITY ERROR. ON ENCOUNTERING AN ERROR, AN ACCEPT 
MESSAGE IS SENT TO THE OPERATOR GIVING HIM THE OPTION OF CONTINUING 
OR STOPPING. IF THE PRINTOUT IS RESUMED, ALL LINES READ WITH A 
PARITY ERROR ARE FLAGGED ON THE OUTPUT. 


ALLOWABLE RESPONSES ARE DS AND OK. IF DS IS ENTERED, PROCESSING OF 


THE CURRENT BACKUP FILE IS DISCONTINUED. IF OK IS ENTERED, 
PROCESSING CONTINUES. IF ANYTING ELSE IS ENTERED, THE ACCEPT IS 
REPEATED. 

DO334 BACKUP — SUPPRESS INCLUDED CARDS - 06-ec4—-73 


AN OPTION "NOINCL" HAS BEEN ADDED TO BACKUP. WHEN THIS OPTION IS 
SPECIFIED, THOSE CARDS WHICH WERE INCLUDED IN A PROGRAM BY A $ 
INCLUDE CARD WILL NOT BE PRINTED. THIS FEATURE IS USEFUL ONLY WHEN 
PRINTING PROGRAM LISTINGS. A KEY MUST BE SPECIFIED WHEN USING THIS 
OPTION, SINCE BACKUP LOOKS FOR A DIGIT TWO CHARACTERS IN FRONT OF 
THE SEQUENCE NUMBERS. 


DO420 BACKUP - FILE TITLE PRINTED - o6-24-73 FACE © 


pow20 BACKUP - FILE TITLE PRINTED - 06-24-73 

BACKUP NOW DISPLAYS THE NAME OF THE BACKUP FILE IT IS PRINTING. IF 
NO FILE EXISTS FOR THE REQUEST, THE MESSAGE "NO FILE FOUND" IS 
DISPLAYED. 


DOYS — BACKUP = NON-DIRECT QUTPUT FILE OPTION - 08-26-73 

THIS PATCH IMPLEMENTS THE ABILITY TO SPECIFY THAT BACKUP IS TO USE 
A NON-DIRECT FILE FOR OUTPUT. THIS IS ACCOMPLISHED BY INCLUDING 
THE PARAMETER "ND" IN THE INPUT STRING, E.G., ?PB D 607 ND SAVE. 
THE FILE USED IS CALLED “BFILE", AND MAY BE LABEL EQUATED TO 
ANYTHING ALLOWABLE, SUCH AS DISK, PRINTER BACKUP TAPE, PRINTER, 
PUNCH, ETC. IF IT IS EQUATED TO A DISK FILE, THE FILE WILL BE 
LOCKED WHEN BACKUP IS DONE. 


NEW FEATURES AND DOCUMENTATION CHANGES Ege 3S) 


DO0335 BASIC - "DEF FN" FUNCTIONS IMPROVEMENT —- 06-24-73 


A BASIC PROGRAM MAY NOW HAVE A "FN" FUNCTION WHICH HAS THE SAME 
NAME AS A VARIABLE C(I-E., THE FUNCTION "FNA" AND THE VARIABLE "A" 
MAY NOW APPEAR IN THE SAME BASIC PROGRAM) . 


DONWSO = BASIC . = EXTENOED INPUT AND OUTPUT = O8re6773 

THE B6700 BASIC LANGUAGE HAS BEEN EXPANDED TO ALLOW THE USER MORE 
CONTROL OVER INPUTTING, OUTPUTTING, AND STORING DATA. DETAILED 
INFORMATION CONCERNING THIS EXPANSION IS CONTAINED IN THE BASIC 
LANGUAGE INFORMATION MANUAL (FORM NO. 5000383), WHICH WILL BE 
AVAILABLE AT THE TIME OF THIS RELEASE. 


NEW FEATURES AND DOCUMENTATION CHANGES fare toe 


BINDER 


Dete2 “BINQED eee = 08-19-73 

THIS PATCH IMPLEMENTS HIGHER LEVEL COBOL BINDING. COBOL ROUTINES 
RUNNING AT HIGHER LEXICAL LEVELS CAN REFERENCE INTERMEDIATE LEVEL 
DECLARED ITEMS BY DECLARING THEM TO BE GLOBAL. ALSO, A COBOL 
ROUTINE AT ANY LEVEL MAY BE REPLACED. 


DOYYG BINDER - FORMAL LABELS = 07-23-73 
BINDING 2.4 CODE FILES (ALGOL OR FORTRAN) CONTAINING FORMAL LABELS 
TO CODE FILES COMPILED WITH A 2.3 OR EARLIER RELEASE COMPILERS IS 
NOT ALLOWED. 


DOS = BINDER =~ INTRINSIC BINDING — 08726773 

THE NUMBER OF INTRINSICS THAT THE BINDER IS CAPABLE OF BINDING 
TOGETHER HAS BEEN INCREASED. PREVIOUSLY AN INVALID INDEX WOULD 
OCCUR IF MORE THAN @56 INTRINSICS WERE BOUND INTO A FILE. THE 
BINDER NOW RESIZES ARRAYS WHEN APPROPRIATE IN ORDER TO ACCOMODATE 
LARGER NUMBERS OF INTRINSICS. 


DOWSO BINDER - SINGLE SPACED LISTING - 08-26-73 

THE BINDER NOW SETS THE DOLLAR OPTION "SINGLE" BY DEFAULT. DOUBLE 
SPACED LISTINGS MAY BE OBTAINED ONLY BY SPECIFICALLY RESETTING THE © 
OPTION. THIS FEATURE MAY BE COMPILED OUT OF THE BINDER BY SETTING 
A COMPILE TIME OPTION "DOUBLESPACE" AND RECOMPILING THE BINDER. 


NEW FEATURES AND DOCUMENTATION CHANGES rive, ew 


DOeS5 CANDE - IMPROVE PAPERTAPE I-O HANDLING = Desa 75 


SEVERAL CHANGES HAVE BEEN MADE IN CANDE AND SOURCENDL AFFECTING THE 
HANDLING OF PAPER-TAPE INPUT/OUTPUT USING TELETYPE TERMINALS. 


THE CANDE CHANGES INCLUDE : 
1. CANDE NOW RESPONDS CORRECTLY TO BREAK ON OUTPUT, TERMINATING THE 
OUTPUT. 


@. THE INITIAL-LINE PROTOCOL (DELAY AND NULLS) IS NOW INITIATED 
EXPLICITLY BY CANDE (SETTING TOGGLE 7), SO ERROR OR BREAK 
RECOVERY CAN BE HANDLED CORRECTLY. 


3. THE LIMITING OF OUTPUT MESSAGE QUEUING HAS BEEN CORRECTED FOR 
ALL UNBUFFERED TERMINAL OUTPUT (NOT JUST PAPER TAPE). 


4. CANDE WILL NO LONGER LOSE THE LAST RECORD OF SOME INPUT TAPES. 


5. A PAPER-TAPE INPUT RECORD CONTAINING ONLY A SEQUENCE NUMBER NOW 
CORRECTLY CAUSES A BLANK LINE IN THE FILE, NOT A LINE-DELETION. 


6. CANDE NOW HANDLES ERROR TERMINATIONS FROM PAPER-TAPE INPUT. 
THE SOURCENDL CHANGES INCLUDE : 


1. THE SPECIAL TREATEMENT OF THE HEADING LINE IN PAPER-TAPE 
PUNCHING IS NOW CAUSED BY THE MCS SETTING TOGGLE 7. FORMERLY, 
IT WAS NECESSARY TO ACHIEVE NORMAL COMPLETION OF THE FILE IN 
ORDER TO RE-ARM THE INITIAL LOGIC FOR ANOTHER FILE. 


2. CR (CARRIAGE RETURN) HAS BEEN DEFINED AS THE ONLY CHARACTER 
INDICATING THE END OF A RECORD. ADJACENT CARRIAGE RETURNS CAUSE 
AN EMPTY RECORD. THE FOLLOWING CONTROL CHARACTERS ARE NOW 
IGNORED, NO MATTER WHERE IN THE RECORD THEY APPEAR: 


LF (LINE FEED), NUL, DEL (RUBOUT), DC1 (XON), DCS (XOFF), 


3. A 15-SECOND TIMEOUT ON THE FIRST INPUT CHARACTER NOW CAUSES 
"TERMINATE ERROR" RATHER THAN "TERMINATE NOINPUT" ACTION. 


4, BREAK-ON-INPUT, END-OF-BUFFER AND NO-SPACE CONDITIONS NOW CAUSE 
"TERMINATE NOINPUT" (TO FREE THE STATION) FOLLOWED BY "TERMINATE 
ERROR" ACTION. 


5. LEADER AND TRAILER ARE NOW NUL (BLANK TAPE) RATHER THAN DEL 
(RUBOUT) CHARACTERS. THE RUBOUT FOLLOWING EACH LINE HAS BEEN 
OMITTED. 


THE FORMAT OF B6700 CANDE PAPER TAPE IS SPECIFIED BELOW. ALTHOUGH 
THIS FORMAT DIFFERS FROM THE BS5500 CANDE USAGE, B6700 PAPER TAPE 
FUNCTIONS REMAIN COMPATIBLE WITH THE BS5500: EITHER SYSTEM CAN READ 
TAPE PUNCHED BY THE OTHER. THE DESCRIPTION USES ANSCI1I-67 CONTROL 
CODES, WITH TELETYPE SYNONYMS SHOWN IN PARENTHESES. 


Seed li 

~ PRIOR TO PUNCHING THE HEADING FOR A PAPER TAPE, THE DCP DELAYS FIVE 
SECONDS FOR THE USER TO TURN ON HIS PUNCH. THEN IT SENDS NINE NUL 
CHARACTERS (BLANK LEADER), THE HEADING (FILE NAME), AND 40 MORE 
NULS. 


-EACH LINE OF THE FILE IS TRANSMITTED AS THE SEQUENCE NUMBER (UNLESS 
SUPPRESSED BY THE “UNSEQUENCED" FORMAT OPTION), FOLLOWED WITHOUT 
SPACE BY THE TEXT, FOLLOWED BY 


CR (CARRIAGE RETURN) 
LF (LINE FEED) 
DC1 (XON). 


(THE DC1 PROVIDES 85500 COMPATIBILITY, AS WELL AS CARRIAGE-RETURN 
DELAY.) IF THE SEQUENCE NUMBER IS PRESENT, IT IS FILLED WITH 
LEADING ZEROS TO MAXIMUM WIDTH (E.G. 8 DIGITS). 


AFTER THE LAST LINE, A DC3 (XOFF) CHARACTER IS PUNCHED, FOLLOWED BY 
4Q NULS FOR TRAILER. (THE XOFF IN THE TAPE WILL STOP SOME PAPER- 
TAPE READERS.) THE DCP THEN DELAYS FIVE SECONDS FOR THE USER TO 


TURN OFF HIS PUNCH, BEFORE TRANSMITTING THE FINAL "#"., 
INPUT: 


AFTER THE USER ENTERS A "TAPE" COMMAND, CANDE SENDS "#0K" FOLLOWED 
BY CR, LF AND DC1 (XON). THE XON WILL AUTOMATICALLY START THE 
PAPER-TAPE READER ON SOME TERMINALS; OTHERWISE THE USER MUST START 
Ti MANUALLY WITHIN 15 SECONDS. IF FIFTEEN SECONDS ELAPSES WITH NO 
INPUT, THE DCP SIGNALS AN ERROR TERMINATION AND CANDE SENDS A 
MESSAGE TO THE TERMINAL. ONCE INPUT HAS BEGUN, IT CONTINUES UNTIL 
THE PAPER-TAPE READER STOPS (AS NOTED BY 500 MILLISECONDS WITH NO 
NEW CHARACTER). DURING INPUT, A CR (CARRIAGE RETURN) DELIMITS A 
LINE. THE FOLLOWING CHARACTER CODES ARE IGNORED (DISCARDED BY THE 
DCP): 


LF (LINE FEED) 


NUL 
~ DEL (RUBOUT) 
DC1 (XON) 
OC3 (XOFF) 


INPUT TAPES MAY CONTAIN SEQUENCE NUMBERS OR NOT; THE "SEQ" OPTION 
MUST BE SPECIFIED ON THE "TAPE" COMMAND IF CANDE IS TO SUPPLY 
SEQUENCE NUMBERS. LEADING ZEROS IN SEQUENCE NUMBERS MUST BE 

SUPPLIED ONLY IF THE FIRST CHARACTER OF TEXT IS A DIGIT, SINCE THE 
TEXT FIELD BEGINS WITH THE FIRST NON-DIGIT OR AFTER THE MAXIMUM 
NUMBER OF DIGITS FOR A SEQUENCE NUMBER. 


ERRORS : 

_THE PAPER TAPE INPUT WILL BE TERMINATED IF NO INPUT APPEARS FOR 15 
SECONDS, IF BREAK IS DETECTED ON THE LINE, IF A RECORD EXCEEDS 
MAXIMUM INPUT LENGTH, OR IF THE DCP FAILS TO ACQUIRE MESSAGE SPACE 
WHEN NEEDED. INPUT FOLLOWING THE ERROR IS DISCARDED. AN INVALID- 
STOPBIT ERROR IS TREATED BY SUBSTITUTING "?" FOR THE GARBLED 
CHARACTER; INPUT IS NOT ABORTED. 


DOe95 CANDE - PIPROVE PAPERTAPE I-OQ HANDLING —- OQ4-23- Geo pe 


THE MINIMUM REQUIREMENT FOR CANDE INPUT IS THAT EACH LINE BE 
TERMINATED BY CR. IN ORDER THAT THE OUTPUT BE READABLE ON THE 
TELETYPE AS THE TAPE iS BEING READ, IT IS RECOMMENDED THAT EACH 
LINE BE TERMINATED BY CR, LF AND DEL (RUBOUT) OR NUL. THE LF 
ADVANCES THE PAPER, AND THE RUBOUT OR NUL GIVES THE CARRIAGE TIME 
TO RETURN. LEADER OR TRAILER TAPE MAY BE PUNCHED USING THE REPEAT 
KEY WITH DEL (RUBOUT). OR NUL. (NUL MAY BE PUNCHED ON MANY 
TELETYPEWRITERS USING SHIFT, CONTROL, AND "P".) ERRORS COMMITTED 
IN PUNCHING THE TAPE MAY BE REPAIRED BY BACKSPACING THE PAPER TAPE 
AT THE PUNCH, TYPING RUBOUT, AND THEN TYPING THE CORRECT CHARACTER. 
(THERE IS USUALLY A  BACKSPACE ON THE PAPER-TAPE PUNCH FOR THIS 
PURPOSE . ) . 


DOS02. (CANDE ~ EXECUTE WET PARAMETER. (a asescis 

IN AN EXECUTE COMMAND WITH FILENAME SPECIFIED, A SINGLE PARAMETER 
MAY BE OPTIONALLY PROVIDED. THE PARAMETER MUST BE A QUOTED EBCDIC 
STRING; IT APPEARS IN PARENTHESES AFTER THE FILENAME. (THE STRING 
LENGTH IS LIMITED ONLY BY INPUT RECORD SIZE.) THE .CORRESPONDING 
ACTUAL PARAMETER MUST BE A REAL ARRAY. EXAMPLE: 


EXECUTE UTILITY ("CONTROLTEXT" ) 


THE TEXT BETWEEN THE. QUOTES IS FOLLOWED BY AT LEAST ONE NUL 
CHARACTER AND THEN PADDED WITH MORE NUL CHARACTERS (AT THE RIGHT 
END) TO A WORD BOUNDARY, AND INSERTED IN A MINIMUM-LENGTH ARRAY. 


00302 CANDE — ALLOW WORKFILE RECOMPILE - QN-e3 773 

IF AN EXPLICIT COMPILE COMMAND. FOR THE WORKFILE IS ENTERED WHEN A 
VALID OBJECT FILE EXISTS, CANDE WILL NOW INFER A "REMOVE OBJECT" 
AND DO THE COMPILATION. (CANDE USED TO REJECT THE COMPILE.) 


DO303 CANDE - REVERSION TO NO CHARGECODE - 04-23-73 RARE: 2 


—— ee ee i ee ae ee ew wr Oe — — eee ee ee 


D0303 CANDE - REVERSION TO NO CHARGECODE = 04-23-73 

IF THE "CHARGE" COMMAND IS NULL (CONTAINS NO CHARGECODE), THE 
SESSION REVERTS TO THE CONDITION OF NO CHARGECODE SPECIFICATION. 
(IN II.3  CANDE, A CHARGE RECORD WAS LOGGED WITH THE USERCODE IN 
PLACE OF THE CHARGECODE. IN II.4 CANDE AS RELEASED, A "CHAOS" 
MEMORY DUMP IS PRODUCED. HENCEFORTH, AN MCS-TIMES RECORD WILL "LOG 
OFF" THE CHARGECODE, AND A NEW LOG-ON WILL BE RECORDED WITHOUT 
CHARGECODE . ) . 


DO304 CANDE  - NOTE OBJECT FILE ONLY IF CODE — ONTeS~7S 

THE “OBJECT-FILE PRESENT" INDICATION WILL BE SET BY A "GET" COMMAND 
ONLY IF THE FILE IS AN EXECUTABLE CODEFILE. IF YOU “GET X" AND THE 
FILE "OBJECT/X" EXISTS BUT IS NOT CODE, THE OBJECT FILE WILL BE. 
IGNORED. (PREVIOUSLY, THE "OBJECT FILE PRESENT“ INDICATION WAS 
SET, BUT AN ATTEMPT TO EXECUTE THE WORKFILE GAVE “DS-ED NO 
CODEFILE".) 


DO305 CANDE - FIX COL RANGE IN FIND- REPLACE = 04-25-13 


THE COLUMN-RANGE CHECKING IN FIND/REPLACE COMMANDS HAS BEEN 
CORRECTED SO THAT THE LAST COLUMN IN THE USABLE RECORD IS NOW 
ACCESSIBLE. THE FOLLOWING RESTRICTIONS SHOULD BE NOTED: 


THE COLUMN-RANGE SPECIFICATION 
@<COL> - <COLe> 
MAY REFER TO ANY PART OF THE USABLE RECORD EXCEPT THE 


SEQUENCE-NUMBER FIELD. (FOR EXAMPLE, AN ALGOLSYMBOL FILE 
PRODUCED BY THE COMPILER HAS S0-CHARACTER RECORDS; THE RANGE 
MAY INCLUDE ANY OF COLUMNS 1-72 OR 81-90.) THE DEFAULT 


COLUMN RANGE IS THE TEXT FIELD (1-72, FOR EXAMPLE). 


A 4 
DOS05 CANDE - FIX COL RANGE IN FIND-REPLACE - One 23> Bk oe 3 


THE TARGET SPECIFICATION FORM 
COLUMN <COL1> -—.<COLe> 


IS LIMITED TO THE (DEFAULT OR EXPLICIT) COLUMN RANGE FOR THE 
REPLACE COMMAND. THUS 


REPLACE COL 83-87 /013/ .@81-90 
IS VALID, BUT 
REPLACE COL 83-87 /013/ 


CONTAINS INVALID COLUMN SPECIFICATIONS (FOR THE ALGOLSYMBOL 
EXAMPLE). . 


DO306  CANDE - LIST CHANGES OPTIONS - 05-19-73 
THREE NEW OUTPUT FORMAT OPTIONS HAVE BEEN IMPLEMENTED FOR THE LIST 
COMMAND, TO SHOW ALTERATIONS WHICH HAVE BEEN MADE IN A. WORKF ILE 
SINCE THE LAST UPDATE. THE NEW OPTIONS ARE: 


FLAG (MINIMUM ABBREVIATION "F"): 


THE FILE IS LISTED IN FULL, WITH TWO EXTRA SPACES 
BEFORE EACH LINE. THE SPACES ARE BOTH BLANK IF THE 
LINE IS UNALTERED. THE. FIRST SPACE. ‘BECOMES "I",. "R", 
OR "F" FOR A LINE WHICH WAS INSERTED, REPLACED, OR 
FIXED, RESPECTIVELY. DELETED LINES ARE NOTED BY A *-" 
FOLLOWED BY THE SEQUENCE NUMBER (FOR SINGLE-LINE 

DELETION) OR SEQUENCE-NUMBER RANGE. 


CHANGES (MINIMUM ABBREVIATION "CH"): 


THE FILE IS LISTED WITH FLAGGING, AS DESCRIBED ABOVE, 
BUT UNALTERED LINES ARE SUPPRESSED. 


COMPARE (MINIMUM ABBREVIATION "CO"): 


THE FILE IS LISTED WITH FLAGGING, WITH UNALTERED LINES 
SUPPRESSED. ANY LINES DELETED, REPLACED OR FIXED ARE 
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LISTED IN FULL IN UNMODIFIED FORM, FLAGGED BY "-". 
BLANK LINES ARE INSERTED TO SEPARATE THE LISTING INTO 
GROUPS, WHERE A GROUP CONTAINS A SINGLE REPLACE OR FIX 
(LISTED BEFORE AND AFTER) OR AN INSERTION OR A DELETION. 
CONSECUTIVE INSERTED OR DELETED LINES ARE SHOWN AS A 
SINGLE GROUP. 
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THE SEVERAL OPTIONS ARE ILLUSTRATED IN THE FOLLOWING EXCERPT FROM A 
CANDE SESSION (REPRODUCED HERE IN THREE COLUMNS): 


GET TsL. L L:CH 
#WORKFILE T: SEQ, 10 A - 20 

Q RECORDS, SAVED 30 C I 35 CD 
10 A 35 CD Es70e 
208 37 OC R40 De 
30 C 40 De ~ 60-80 
40 D 50 £ F 90 XI 
50 £ 90 XI # 
60 F # L:co 
70 G L:F 
80 H 110A - 208 
so I - 20 
# 30 C | 1 35 CD 
20 1 35 CD 1 37 OC 
35CD 1.37 DC 
37DC R40 De . - 40 D 
4oODe 50 £ R 40 De 
DEL 60-80 - 60-80 
# F 90 XI —~ 60 F 
F90//X # ~ 70 G 
# - 80H 

- 90 1 
F 90 XI 


# 


THE ALTERATIONS WHICH CAN BE SHOWN ARE ANY DELETIONS, FIXES OR 
SINGLE-LINE ENTRIES WHICH HAVE BEEN ENTERED SINCE THE LAST TIME THE 
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WORKFILE WAS UPDATED. AN UPDATE 1S PERFORMED WHEN AN "UPDATE" 
COMMAND IS ENTERED, OR AUTOMATICALLY WHEN NEEDED: UPDATE IS FORCED 
BY MERGE, RMERGE, EXCLUDE, INSERT, MOVE OR’ RESEQ. WHEN THE 
WORKFILE HAS ANY ALTERATIONS, UPDATE 1S FORCED PRIOR TO PERFORMING 
MANY OTHER COMMANDS, SUCH AS COMPILE, EXECUTE, TYPE, FIND OR SAVE. 

A LIST DOES NOT FORCE UPDATE, SO THE SAME ALTERATIONS MAY BE SHOWN 
ON SEVERAL SUCCESSIVE LIST COMMANDS. 


SEVERAL LIST OPTIONS ARE INDEPENDENT: ONE MAY SELECT UNSEQUENCED, 
TRUNCATED, OR SQUASHED INDEPENDENTLY OF EACH OTHER OR THE OTHER 
OPTIONS. HOWEVER, THE FOLLOWING OPTIONS ARE MUTUALLY EXCLUSIVE, 
AND HAVE A PRECEDENCE IN THE ORDER LISTED (FROM HIGH TO LOW): 
PUNCH, COMPARE, CHANGE, FLAG. IF MORE THAN ONE OF THESE OPTIONS 
APPEARS, IN WHATEVER ORDER, THE ONE HAVING HIGHEST PRECEDENCE 1S 
OPERATIVE. 


DO360 CANDE —- TERMINAL CAPACITY LIMITS - OQ4-23-73 


THE DEFAULT VALUES FOR THE TERMINAL SPECIFICATIONS ARE DERIVED FROM 
NDL PARAMETERS; THEY MAY BE ALTERED BY "TERM". THE DEFAULTS FOR 
LINE, PAGE AND BUFFER ARE NOW LIMITED TO 255, 255, AND 4095, 
RESPECTIVELY. ‘LARGER SPECIFICATIONS WILL BE CUT BACK TO THESE 
LIMITS. (FORMERLY, THEY WERE TAKEN MODULO 256, 256, OR 4096, BY 
FIELD TRUNCATION.) IT ADDITION TO THESE UPPER BOUNDS, A LOWER 
BOUND OF 25 IS APPLIED TO LINE. 


DOS61 = CANDE == WRITE COMMAND — 06-24-73 

A NEW CANDE INPUT/OUTPUT COMMAND, WRITE, HAS BEEN IMPLEMENTED TO 
ALLON THE USER TO HAVE FILES (OR PORTIONS THEREOF) LISTED ON THE 
LINE PRINTER OR PUNCHED ON CARDS. THE SYNTAX RESEMBLES THAT FOR 
LIST: THE KEYWORD "WRITE" (MINIMUM ABBREVIATION “W"). FOLLOWED 
OPTIONALLY BY A FILENAME, SEQUENCE RANGE LIST, COLUMN RANGE, OUTPUT 
DEVICE, AND/OR OUTPUT FORMAT OPTIONS. 
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SYNTAX: 
WRITE 


<FILENAME> 
<SEQUENCE RANGE LIST> 


@ <COLUMN RANGE> 
ae Reese 

TO PRINTER 
i ans 


9 
NUMBERED 
DOUBLE 
UNSEQUENCED 
SQUASHED 
TRUNCATED 
HEXPLICIT 
UPCASED 


BY DEFAULT, THE CONTENTS OF THE WORKFILE ARE PRINTED ON THE LINE 
PRINTER. THE USER MAY SPECIFY THE OUTPUT DEVICE AS EITHER LINE 
PRINTER OR CARDS. IF A FILENAME IS SPECIFIED IT 1S PRINTED 
(PUNCHED) IF THE USER HAS ACCESS PRIVILEGES. ONE OR MORE SEQUENCE 
RANGES IN ASCENDING ORDER MAY BE SELECTED; OTHERWISE, THE WHOLE 
FILE IS WRITTEN. 


A COLUMN RANGE, IF PROVIDED, INDICATES THAT ONLY THE SPECIFIED PART 
OF EACH LINE IS TO BE OUTPUT (BEGINNING IN COLUMN 1 FOR CARDS AND 
COLUMN 13 FOR PRINTERS). THE KEYWORD —"ALL" IS MEANINGFUL FOR 
PRINTERS ONLY AND CAUSES THE ENTIRE CONTENTS OF EACH RECORD TO BE 
PRINTED UNEDITED. 


SEVERAL OUTPUT FORMAT OPTIONS ARE AVAILABLE FOR THE LINE PRINTER; 
THEY ARE IGNORED FOR CARDS. THE OPTIONS AND THEIR EFFECTS ARE: — 


1. NUMBERED THE RECORD NUMBER OF EACH RECORD IS PRINTED 
IN COLUMNS 115-120. 
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2. DOUBLE LISTINGS ARE DOUBLE SPACED. 


3. UNSEQUENCED THE SEQUENCE NUMBER LISTED AT THE BEGINNING 
OF EACH LINE IS SUPPRESSED. 


4. SQUASHED ANY GROUP OF MULTIPLE BLANKS IS REDUCED TO A 
SINGLE BLANK. 


5. TRUNCATED IF THE TEXT PORTION OF A RECORD WILL NOT FIT 
IN THE AVAILABLE SPACE ON A LINE, IT IS 
TRUNCATED TO ONE LINE (AND TERMINATED BY A 
wypey 


6. HEXPLICIT IF A RECORD CONTAINS NON-GRAPHIC CHARACTERS, 
THE RECORD WILL BE PRINTED ON TWO LINES: THE 
TWO CHARACTERS REPRESENTING THE HEXADECIMAL 
NOTATION OF THE NON-GRAPHIC CHARACTER WILL 
APPEAR VERTICALLY, THE FIRST HEX-CHARACTER 
ON THE FIRST LINE, THE SECOND HEX-CHARACTER 
(IMMEDIATELY BELOW THE FIRST) ON THE SECOND 
LINE. LOWER-CASE LETTERS ARE PRINTED IN 
UPPER CASE WITH A’ HYPHEN UNDERSCORE. A 
BLANK LINE SEPARATES EACH RECORD; THE 
"DOUBLE" OPTION IS IGNORED. 


Ta UPCASED ANY LOWER CASE LETTERS IN THE RECORD WILL BE 
TRANSLATED TO THEIR UPPER CASE EQUIVALENT. 


PRINTER LINES ARE FORMATTED AS FOLLOWS: THE SEQUENCE NUMBER OF. THE 
LINE APPEARS RIGHT JUSTIFIED IN COLUMNS 1-8 (PSEUDO SEQUENCE 

NUMBERS FOR TYPE DATA OR CDATA FILES) WITH LEADING ZEROS OMITTED, 
FOLLOWED BY FOUR BLANKS AND THE TEXT OF THE LINE. THE SEQUENCE 
FIELD OF THE RECORD IS PRINTED BEYOND THE TEXT FIELD (STARTING IN 
COLUMN 93), EXCEPT FOR UNSEQUENCED FILES. IF PATCH MARKS OR 
COMMENTARY ARE PRESENT IN COLUMNS 81-90 OF ALGOL, ESPOL, OR DCALGOL 
FILES, THEY ARE PRINTED FOUR SPACES BEYOND THE SEQUENCE FIELD. IF 
THE SEQUENCE FIELD OF A RECORD CONTAINS NON-NUMERIC CHARACTERS OR 
THE SEQUENCE NUMBER IS LESS THAN OR EQUAL TO THE PRECEDING SEQUENCE 
NUMBER, THE NUMBER IS FLAGGED AS HAVING A SEQUENCE ERROR. THE 


DO361 CANDE - WRITE COMMAND —- 06-24-73 


THE REST OF THE TEXT BY TWO BLANKS. (ALL LINE FORMATTING BEYOND 
THE TEXT FIELD IS SUPPRESSED WHEN A COLUMN RANGE IS SPECIFIED.) 


IF THE TEXT PORTION OF A RECORD WILL NOT FIT IN THE SPACE AVAILABLE 
ON A PRINT LINE, IT IS SPLIT; LONG RECORDS ON CARDS ARE TRUNCATED. 


NON-EBCDIC FILES ARE TRANSLATED TO EBCDIC FOR WRITING. 


AS WITH ANY OUTPUT GENERATED BY A USER, BACKUP FILES CREATED BY 
USING THE WRITE VERB ARE NOT ACTUALLY PRINTED OR PUNCHED UNTIL THE 
USER EITHER LOGS OFF OR USES THE SPLIT COMMAND. 


THE DIAGNOSTIC FACILITIES IN CANDE, ENABLED BY COMPILING WITH THE 
“DEBUG" OPTION: SET, HAVE BEEN EXTENDED TO PERMIT SELECTIVE 

DEBUGGING BY STATION. A DIFFERENT SET OF OPTIONS MAY BE SPECIFIED 
FOR EACH STATION, IF DESIRED. THE SYNTAX OF THE ?BUG CONTROL 
STATEMENT HAS BEEN EXTENDED TO ACCEPT AN OPTIONAL STATION LIST TO 
FOLLOW THE DEBUG SPECIFICATIONS. THE STATION LIST, IF IT APPEARS, 
IS ENCLOSED IN BRACKETS; ITEMS ARE SEPARATED BY COMMAS. EACH ITEM 
MAY BE A LOGICAL-STATION NUMBER, STATION NAME, D:L:S, OR AN 
ASTERISK. THE DEBUG SPECIFICATIONS ARE APPLIED TO EACH STATION IN 
THE LIST; ASTERISK DENOTES THE STATION FROM WHICH THE ?BUG COMMAND 
IS ENTERED. IF NO LIST APPEARS, THE SPECIFICATIONS ARE APPLIED TO 
ALL STATIONS. THE FOLLOWING EXAMPLE SHOWS INPUT COMMANDS FOLLOWED 
BY THE RESPONSES. 


?BUG 124 
#BUGWORDS=000000000016 


?BUG A 46 [TTY7,17,0:21) 
#BUGWORDI 9 1=BFFFFFFFFFFF 
#BUGWORDI 17 1=BFFFFFFFFFFF 
#BUGWORDI 34 ]=BFFFFFFFFFFF 


?BUG —-4 


\y 
DO368 CANDE - DEBUG SELECTIVELY BY STATION - p7siiegs : 


#BUGWORDS=000000000006 


?BUG [*] 
#BUGWORDI[ 17)=BFFFFFFFFFEF 


NOTE THAT WHEN NO STATION LIST APPEARS, THE RESPONSE SHOWS THE 
SETTINGS FOR ALL STATIONS FOR WHICH NO INDIVIDUAL SPECIFICATIONS 
APPLY. WHEN THE NEW OVERALL SPECIFICATION IS A MODIFICATION (SUCH 
AS -4), IT APPLIES TO ALL STATIONS, BUT THE PRIOR SETTINGS OF OTHER. 
BITS FOR SPECIFIC STATIONS REMAIN UNCHANGED (SO STATION 17 CHANGED 
FROM BFFFFFFFFFFF TO BFFFFFFFFFEF, IN THIS EXAMPLE). 


THE SPECIFIED DEBUG SETTINGS APPLY WHENEVER CANDE ACTIVITY IS 
ATTRIBUTABLE TO SERVING THAT STATION IN PARTICULAR. AT TIMES WHEN 
IT IS IMPOSSIBLE TO ATTRIBUTE ACTIVITY TO ANY ONE STATION, THE 
DEBUG SETTINGS ARE TAKEN AS THE LOGICAL OR OF ALL SETTINGS SELECTED 
FOR ANY STATION. SUCH CASES ARISE DURING CERTAIN ADMINISTRATIVE 
ACTIVITY, WHEN PROCESSING SM AND OTHER NON-STATION MESSAGES, AND 
WHEN PROCESSING CONTROL MESSAGES. 


A COMMA IS NOW AN ACCEPTABLE DELIMITER BETWEEN DUBUG SPECIFICATIONS. 


DO369 CANDE PAGED OUTPUT FROM FILES-LFILES —- 07-14-73 


OUTPUT FROM THE FILES AND LFILES COMMANDS WILL NOW BE PAGED IN 
SIMILAR FASHION TO OUTPUT FROM LIST, FIND AND REPLACE. THE OUTPUT 
IS CONTROLLED BY THE SAME TERMINAL SPECIFICATION (DEFAULT OR 
SPECIFIED BY THE TERMINAL COMMAND): IF PAGE EXCEEDS ONE AND WAIT IS 
TRUE, THE APPROPRIATE NUMBER OF LINES ARE SENT AND THE USER MUST 
RESPOND WITH ANY NON-CONTROL RECORD TO RECEIVE MORE OUTPUT. (A #? 
INDICATION APPEARS, BECAUSE SYSTEM/LISTFILES OPENS AN INPUT/OUTPUT 
FILE TO RECEIVE THE RESPONSE.) NOTE THAT SYSTEM/LISTFILES IGNORES 
THE BUFFER SPECIFICATION IN SENDING ITS OUTPUT; IT SENDS ONE LINE 
AT A TIME. . ON TERMINALS WHERE THE BUFFER IS SMALLER THAN THE 
SCREEN, THIS MAY RESULT IN SOME LINES BEING LOST BEFORE THE ENTIRE 
PAGE HAS BEEN SENT; IT MAY BE NECESSARY TO SPECIFY AN ARTIFICIALLY 
SMALL PAGE SIZE, ESPECIALLY FOR LFILES (WHICH TENDS TO FILL THE 


DO369 CANDE -— PAGED OUTPUT FROM FILES-LFILES - o7aeye te 


OUTPUT LINES). 


DO¥S1 = CANDE == CHAR FILES: CDATA,CSEQDATA - 08-26-73 

CANDE CAN NOW READ CHARACTER FILES (UNITS=CHARACTERS, INTMODE = 
EBCDIC, BCL OR ASCII); IT CAN WRITE SUCH FILES PROVIDING MAXRECSIZE 
IS EVEN AND THE MODE IS NOT BCL. 


CANDE NOW CREATES AND RECOGNIZES TWO NEW TYPES (FILEKINDS): CDATA 
AND CSEQDATA (MINIMUM ABBREVIATIONS CD AND CS). WHEN CREATED BY 
CANDE, BOTH ARE S80-CHARACTER RECORDS IN BLOCKS OF 2160 EBCDIC 
CHARACTERS. CDATA FILES ARE UNSEQUENCED; CSEQDATA FILES HAVE 
SEQUENCE NUMBERS IN COLUMNS ONE THROUGH FIVE, WITH COLUMN SIX BLANK. 
THESE TYPES ARE COMPATIBLE WITH BASIC INPUT/PRINT AND READ/WRITE 
STATEMENTS, RESPECTIVELY. 


CANDE NOW DISALLOWS ANY FILE WITH MODE NOT EBCDIC, BCL OR ASCII. 


DOSE  PANDE 2 ROGON We OUT: EAS OMORD ESUAEE. «2. 0812-75 

USERS AUTHORIZED TO RUN WITHOUT PASSWORDS MAY NOW LOG ONTO CANDE. 
THE USER MAY ENTER HIS USERCODE FOLLOWED BY A PERIOD (".") TO 
INDICATE HE WILL NOT PROVIDE A PASSWORD. A PERIOD MAY ALSO BE USED 
AS A RESPONSE TO THE “ENTER PASSWORD" REQUEST. 


THE USER MAY ABORT THE LOGON OR PASSWORD-CHANGE SEQUENCE BY 
ENTERING A NULL INPUT WHEREVER A PASSWORD IS REQUESTED. THIS 
ESCAPE MECHANISM SPARES A USER FROM HAVING TO ENTER A PASSWORD AND 
RECEIVE A SECURITY ERROR WHEN HE KNOWS THE USERCODE WAS INCORRECT. 


DOY53 CANDE - DISALLOW CERTAIN SM COMMANDS. - 08-19- “73 


CANDE WILL NOW DISALLOW CERTAIN CONTROL COMMANDS AS SM INPUT FROM 
THE SYSTEM CONSOLE. THESE COMMANDS HAD NO MEANING IF ENTERED FROM 
THE CONSOLE AND COULD CAUSE CANDE FAULTS OR MEANINGLESS RESPONSES. 
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THE EXCLUDED COMMANDS ARE: END, DENY, MCS, DS, SPO, AND WRU. 


DOE? “CONDE. = DABGIN« “SEQUENCE 2 UB2!9—7s 

CANDE PROCESSING OF THE MARGIN (@) COMMAND HAS BEEN REWRITTEN, 
ALONG WITH SEVERAL ASPECTS OF HANDLING SEQUENCE MODE. A NUMBER OF 
PROBLEMS WERE ELIMINATED, AND BETTER CHECKING IS BEING PERFORMED. 


TWO NEW SYNTACTIC CONSTRUCTS ARE AVAILABLE: 


- @? 
OR ; 
MARGIN? 


‘CAUSES CANDE TO DISPLAY THE CURRENT MARGIN SETTING. 
<SEQUENCE >@<COLUMN> : <NEW LINE TEXT> 

NOW HAS THE SAME EFFECT AS 
®<COLUMN> : <SEQUENCE><NEW LINE TEXT> 

WHEN CANDE IS NOT RUNNING IN AUTOMATIC SEQUENCE MODE. 


NOTE THAT AN “@" MUST APPEAR TWICE ("@@") IF IT IS TO BE ENTERED AS 
THE FIRST CHARACTER FOR A LINE; THIS RULE NOW APPLIES WHETHER OR 
NOT SEQUENCE MODE IS ACTIVE. 


CANDE NOW INCORPORATES A NEW MECHANISM FOR HANDLING FAULTS AND 
ERRORS. WHEN A FAULT OR ERROR IS DETECTED, CANDE ATTEMPTS TO 
MINIMIZE ITS EFFECT: IF THE PROBLEM CAN BE ASCRIBED TO A PARTICULAR 
USER, THAT USER WILL BE NOTIFIED AND HIS CURRENT OPERATION 
TERMINATED, WHILE SERVICE TO OTHER USERS CONTINUES. (THERE REMAIN- 
SOME CASES WHERE IT IS IMPOSSIBLE OR UNSAFE TO CONTINUE PROCESSING, 
WHEN CANDE MUST BE TERMINATED.) IN THE CURRENT CONTEXT, A "FAULT" 
IS DEFINED AS AN ILLEGAL SITUATION DETECTED BY THE B6700 HARDWARE, 


4 
DO4¥55 CANDE —- FAULT AND ERROR HANDLING -—- 08-19-73 Boe . 


SUCH AS INDEXING OUTSIDE THE BOUNDS OF AN ARRAY; AN "ERROR" IS 
DEFINED AS AN ILLEGAL SITUATION DETECTED BY THE CANDE PROGRAM, SUCH 
AS A VIOLATION OF ITS BUFFER-ALLOCATION PROTOCOL. FAULTS AND 
ERRORS ARE HANDLED ALIKE, EXCEPT FOR THE MESSAGES REPORTING THEM: 


FAULT MESSAGE: #CANDE FAULT FF @LLLLLLLL 
ERROR MESSAGE: #CANDE ER: EEEEEE@GLLLLLLLL 


FF REPRESENTS A TWO-DIGIT FAULT CODE, EEEEEE AN ERROR LITERAL, AND 
LLLLLLLL A LINE NUMBER IN CANDE. NOTE THAT THESE CRYPTIC MESSAGES 
REFER TO PROBLEMS IN CANDE ITSELF, NOT A USER PROGRAM. CIF 
LINEINFO IS UNAVAILABLE, THE LLLLLLLL IS REPLACED BY AN ADDRESS, 
AA:AAA:A.) 


RECOVERY FROM A FAULT OR’ ERROR CONDITION PROCEEDS GENERALLY AS 
FOLLOWS. THE MESSAGE IS DISPLAYED ON THE CENTRAL OPERATOR CONSOLE. 
A PROGRAMDUMP AND OTHER DIAGNOSTIC INFORMATION IS WRITTEN FROM THE 
CANDE STACK ENCOUNTERING TROUBLE (OCCASIONALLY BOTH STACKS); THIS 
MAY BE SEEN AS A PAUSE IN CANDE RESPONSE. IF THE PROBLEM CAN BE 
ASSOCIATED WITH A USER STATION, THE MESSAGE IS SENT THERE; THE 
MESSAGE IS ALSO SENT TO THE CANDE LOG STATION, IF ACTIVE. THE 
INTERRUPTED OPERATION IS TERMINATED AND APPROPRIATE HOUSEKEEPING 
FUNCTIONS PERFORMED TO RETURN TO A NEUTRAL STATE. USERS WHO NOTICE 
PARTICULAR OPERATIONS OR DATA CAUSING REPEATED PROBLEMS ARE URGED 
TO COMMUNICATE WITH THEIR INSTALLATION MANAGEMENT OR BURROUGHS 
TECHNICAL REPRESENTATIVE, SO THAT THE UNDERLYING PROBLEM MAY BE 
ISOLATED AND CORRECTED. 


THE FOLLOWING TECHNICAL INFORMATION IS OFFERED FOR INSTALLATION AND 
FIELD PERSONNEL . 


FAULTS ARE TRAPPED BY "ON ANYFAULT" STATEMENTS IN THE OUTER BLOCKS 
OF EACH CANDE STACK, AS WELL AS IN CERTAIN SPECIAL ENVIRONMENTS. 
(SOME PROCEDURES CONTAIN "ON" STATEMENTS FOR SELECTED FAULTS WHICH 
MAY ARISE DUE TO EXCESSIVE INPUT DATA; THESE ARE TREATED AS NORMAL 
USER ERRORS. RATHER THAN CANDE PROBLEMS.) BOTH STACKS HAVE BOOLEAN 
VARIABLES USED TO PREVENT RECURSIVE FAULT SITUATIONS OR INHIBIT 
RECOVERY ACTION AT CRITICAL POINTS (NOTABLY THE WAITANDGO 
PROCEDURE) . FAULTS AT SUCH TIMES CAUSE NORMAL OR ABNORMAL 
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TERMINATION OF THE SECOND STACK, AND (HOPEFULLY) NORMAL TERMINATION 
OF THE PRIMARY STACK SO THAT DATACOM ACTIVITY WILL RESTART CANDE. 


THE PROCEDURE MUDDLE IS USED TO FORMAT AND SEND THE FAULT/ERROR 
MESSAGE, AND PROGRAMDUMP THE TROUBLED STACK. IF THERE ARE MESSAGES 
IN THE HOLDQ FOR THE STATION BEING PROCESSED, THEY ARE PRINTED 
FOLLOWING THE PROGRAM DUMP. WHEN RUNNING IN STACKe, MUDDLE COPIES 
COMPILEPARAMS, STA AND WBUFINF INTO ITS LOCAL STACK, SO THAT THESE 
KEY GLOBAL DATA ARE VISIBLE IN THE PROGRAMDUMP. A STACK2 

PROGRAMDUMP IS USUALLY FOLLOWED BY LISTINGS OF THE KEY TANKF ILE 
RECORDS PERTAINING TO THAT STATION AND WORKER. THUS IN MOST CASES, 
A PROGRAM DUMP OF ONLY ONE STACK SUFFICES. FOR THOSE “CHAOS" 
ERRORS WHERE ONE STACK ATTEMPTS TO ACQUIRE A BUFFER IN USE BY THE 
OTHER, A SOFTWARE INTERRUPT CAUSES THE OTHER STACK TO PROGRAMDUMP 
LIGSELF « (CANDE NO LONGER DIRECTLY INVOKES A FULL-MEMORY DUMP. ) 
NOTE THAT ALL THIS DIAGNOSTIC INFORMATION IS WRITTEN TO THE 
TASKFILES FOR THE RESPECTIVE TASKS, AND MAY NOT BE PRINTED IN 
CHRONOLOGICAL ORDER. 


THE PROGRAMDUMPS AND OTHER DIAGNOSTIC DATA FROM RECOVERABLE FAULTS 
AND ERRORS MAY BE SUPPRESSED BY USING THE ?RO47 CONTROL COMMAND; 
THEY MAY BE REINSTATED WITH THE ?SO47 COMMAND. INSTALLATIONS ARE 
URGED TO RUN WITH THE OPTION SET (AS IT IS BY DEFAULT), SINCE THE 
REMAINING CANDE PROBLEMS ARE LIKELY TO BE ELUSIVE AND DIFFICULT TO 
REPRODUCE. A POTENTIAL PROBLEM WITH FAULT RECOVERY IS THAT TROUBLE 
SPO1S WILL BECOME TOLERATED ANNOYANCES AND GO UNREPORTED (AND HENCE 
UNCORRECTED) . 


CANDE ERRORS ARE TRANSFORMED INTO FAULTS BY THE DEFINES "PUNT", 
"PUNT1" OR "PUNX"; THE EBCDIC STRING REPRESENTING THE ERROR LITERAL 
[S:. DIVEDED BY “ZERO. THUS THE LITERAL SHOWS UP JUST BELOW THE 
DIVIDE-BY-ZERO INTERRUPT IN THE PROGRAM DUMP. IN SOME CASES A 
SECOND PARAMETER APPEARS JUST BELOW THE LITERAL. THE ERRORS 
DEFINED IN 2.5 CANDE ARE LISTED BELOW WITH BRIEF DESCRIPTIONS OF 
THE PROBLEMS. 


BUFCNT THE BUFFER COUNTER FOR THE PRIMARY STACK IS NON-ZERO AFTER 
ALL BUFFERS HAVE BEEN DEALLOCATED. 


DO4SS5 = CANDE ~- FAULT AND ERROR HANDLING - 08-19-73 PASE 


CHAOS AN ATTEMPT WAS MADE TO ACCESS A TANKFILE BLOCK THAT IS 
ALREADY IN USE. 

CTF=0 THE CONTROL INFORMATION DESCRIBING CHANGES TO THE WORKF ILE 
APPEARS TO HAVE A NULL ENTRY. THE SECOND PARAMETER IS AN 
INDEX INTO THE CONTROL BLOCK. 

DIOERR AN UNEXPECTED DIRECT-1/0 ERROR WAS REPORTED. THE SECOND 
PARAMETER IS THE VALUE OF THE IOERRORTYPE ATTRIBUTE. | 

NOBUF THE TANK BUFFER POOL IS EXHAUSTED (IN SPITE OF A DISCIPLINE . 
THAT ASSURES THIS CANNOT OCCUR). 

ORPHAN UPON COMPLETION OF AN OPERATION, NOT ALL BUFFERS WERE 
RETURNED TO THE POOL. . 

QEMPTY A. REMOVE FAILED TO FIND A MESSAGE IN A QUEUE WITH NON-ZERO 
QMESSAGECOUNT . THE SECOND PARAMETER IS THE QUEUE 
IDENTIFIER. 

STATE A SWITCHED GO TO STATEMENT ON THE STATION STATE FAILED. 

SWAPPR STACKSWAPPER REPORTED AN ERROR; THE SECOND PARAMETER IS THE 

. ERROR CODE. 

TANK THE TANKFILE DATA FOR RECOVERY IS UNUSABLE. 

USURP A REFERENCE WAS MADE TO A BUFFER NOT ACQUIRED BY THAT STACK 
OR WORKER. (MOST OF THE CHECKING FOR THIS TRAP IS ENABLED 
BY THE "PEDANTIC" COMPILE TIME OPTION.) 

XSBUF A GIVEN STACK OR WORKER ACQUIRED MORE THAN TWO BUFFERS. 


DO4Y56 CANDE —- "END" AS SEQRANGE OR BASE - 08-19-73 


"END" MAY NOW BE USED AS A VALID SEQUENCE RANGE OR BASE. 


"END" MAY APPEAR ANYWHERE IN THE SYNTAX THAT A <SEQUENCE. RANGE> IS 
ACCEPTED, EXCEPT IN MERGE, RMERGE OR EXCLUDE (WHERE IT WOULD BE 
AMBIGUOUS, EXPENSIVE, AND OF NEGLIGIBLE UTILITY); IT REFERS TO THE 
LAST LINE IN THE FILE. 


"END" MAY APPEAR ANYWHERE IN THE SYNTAX THAT A <BASE> IS ACCEPTED, 
EXCEPT RESEQ; IT REFERS TO THE LAST LINE IN THE FILE PLUS THE 
(SPECIFIED OR DEFAULT) INCREMENT. 


FOR EXAMPLE, ASSUME A FILE WHOSE LAST LINE IS AT 14700. 
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DONSS ~~ CANDE == TEND" AS SEQRANGE OR BASE  - 08-19-73 
L END LISTS 14700 
S END+50 SETS SEQUENCE BASE TO 14750 

INS XYZ AT END ~— INSERTS CONTENTS OF FILE "XYZ" AT 


14700+INC, WHERE INC’ IS THE LAST 
INCREMENT SPECIFIED (DEFAULT 100). 


IN THOSE COMMANDS WHERE A FILENAME AND/OR SEQUENCE RANGE MAY APPEAR 
IN EITHER ORDER, THE WORD "END" MUST APPEAR IN QUOTES WHEN USED AS 
A FILENAME. THE FOLLOWING ARE UNAMBIGUOUS AND CORRECT: 


LIST "END" 
LIST END 
LIST END/GAME 


DO514  CANDE - SEPARATELY COMPILED PROCEDURES ~- 09-04-73 
COMPILATION OF SEPARATE PROCEDURES WITH CANDE IS NOW GREATLY 
SIMPLIFIED BY CHANGES IN THE COMPILERS. THE NEW "LIBRARY" 
DOLLARCARD OPTION IN ALGOL, DCALGOL, ESPOL AND FORTRAN PERMIT ONE 
OR MORE PROGRAM UNITS (PROCEDURES, OUTER BLOCKS, SUBROUTINES, 
FUNCTIONS) TO BE COMPILED INTO A SINGLE CODEF ILE, USING THE FILE 
NAME SPECIFIED BY THE USER (OR BY CANDE FOR A WORKFILE). THESE 
COMPILERS SET LIBRARY BY DEFAULT FOR CANDE COMPILATIONS. A LIBRARY 
FILE MAY BE USED AS A SOURCE BY THE BINDER. A LIBRARY FILE 
CONTAINING A SINGLE PROCEDURE CAN BE EXECUTED WITH A PARAMETER. 


EXAMPLE : 
MAKE X A 
100 PROCEDURE P(A); ARRAY AL*]; 
200 BEGIN 


900 END. 
C; SA 


uy 
DO5Si4 CANDE —- SEPARATELY COMPILED PROCEDURES - 09-04- ag re : 


IN THE FOLLOWING EXAMPLE, ASSUME THAT FILE A/B CONTAINS SEVERAL 
PROCEDURES TO BE COMPILED AND BOUND TO HOST A/H WITH THE RESULT 
BEING EXECUTED. 


C A/B 

MAKE X BI 

100 HOST IS A/H 

200 BIND=FROM OBJECT/A/B; 
R 


THIS EXAMPLE DIFFERS FROM A @.4 CASE ONLY IN. THAT THE BIND 
STATEMENT WOULD HAVE BEEN 


200 .BIND=FROM OBJECT/A/=; 


00515 CANDE - DEBUG: LABEL "WRITE" DCHRITES - 09-09-73 

IF THE "DEBUG" COMPILE TIME OPTION IS SET, CANDE WILL MARK EACH 
"WRITE" MESSAGE WITH A MESSAGE COUNT IN MSGL4).f35s1et.. SO RESULTS 
CAN BE UNAMBIGUOUSLY ASSOCIATED WITH WRITES. SEPARATE COUNTERS ARE 
USED IN THE TWO STACKS; THE PRIMARY STACK USES ODD VALUES AND THE 
SECOND STACK EVEN VALUES. 


DO516 CANDE —- AUTOMATIC RECOVERY - 09-09-73 © 


IF A CANDE FAULT OR ERROR OCCURS IN A WORKFILE EDITING OR OUTPUT 
OPERATION (A CANDE "WORKER"), THE FOLLOWING ACTIONS ARE TAKEN TO 
INVOKE THE CONSISTENCY CHECKING OF CANDE WORKFILE RECOVERY: 


1. THE TANKFILE DATA ARE SAVED IN A RECOVERY FILE, AS THOUGH 
THE STATION HAD DISCONNECTED. 


e@. CANDE DISPLAYS "#AUTORECOVERY INITIATED". 


THE ACTION OF A_ “RECOVER" COMMAND IS TAKEN USING THE 
APPROPRIATE RECOVERY FILE. 


DO516 CANDE - AUTOMATIC RECOVERY - 09-09-73 BEeRy AG 


IF THE CONSISTENCY CHECKING FAILS, NORMAL "INVALID RECOVERY FILE” 
ACTION FOLLOWS; SEE CANDE NOTE DO517. 


DO517 CANDE —- REVISED RECOVERY MECHANISM — O97O4="73 
THE CANDE RECOVERY MECHANISM HAS BEEN SUBSTANTIALLY REVISED; THE 
FUNDAMENTAL APPROACH AND THE USER INTERFACE ARE LITTLE CHANGED. 


FILE NUMBERING AND LIMITS 

THE NUMBERING SCHEMES FOR RECOVERY FILES AND WORKFILES HAVE BEEN 
REVISED AND CONSOLIDATED, IMPROVING RELIABILITY AND GREATLY 
REDUCING . OVERHEAD. THE RECOVERY NUMBER TO BE USED AT ANY SESSION 
IS NOW DETERMINED AT THE BEGINNING OF THE SESSION, AND THIS NUMBER 
IS SUFFIXED TO THE "TEXT" AND "CODE" FILES CREATED BY UPDATING AND 
COMPILING THE WORKFILE. IF A RECOVERY FILE MUST BE CREATED, THE 
SAME NUMBER IS SUFFIXED TO THE “RECV" FILE; THE TEXT AND CODE FILES 
NEED NOT BE RENAMED. THE RECOVERY NUMBER CONSISTS OF THE LOGICAL 
STATION NUMBER CIN DECIMAL) FOLLOWED BY ONE DIGIT TO DISTINGUISH 
MULTIPLE RECOVERY FILES FROM THE SAME STATION. 


THE NEW SCHEME IMPOSES A LIMIT OF 10 RECOVERY FILES FROM THE SAME 
STATION, AND A TOTAL OF 25 RECOVERY FILES UNDER ANY ONE USERCODE . 
(THE SECOND LIMIT IS AN ARBITRARY DEFINE, MAXRECFILES, WHICH THE 
INSTALLATION MAY MODIFY BY COMPILING CANDE; ITS UPPER BOUND IS LS.) 
IF 25 OR MORE RECOVERY FILES EXIST, ONLY THE FIRST 25 ARE LISTED AT 
LOG-ON TIME OR BY THE RECOVER COMMAND, AND ANY ATTEMPT TO GET OR 
MAKE ANOTHER WORFILE 1S REJECTED WITH THE MESSAGE © 


#RECOVER OR DISCARD A WORKFILE. 


IF 10 RECOVERY FILES EXIST FOR THE CURRENT STATION, ANY GET OR 
MAKE, OR AN ATTEMPT TO RECOVER A FILE CREATED FROM ANOTHER STATION, 
WILL BE REJECTED WITH A MESSAGE LIKE 


#RECOVER OR DISCARD A WORKFILE IN THE RANGE 230-239 


DO517 CANDE REVISED RECOVERY MECHANISM. - po-gya73 POC ae 


THE PROCEDURE THAT LISTS THE AVAILABLE RECOVERY FILES IS NOW RUN 
WITH THE QUEUE USED FOR SUCH OPERATION AS REMOVE, TITLE, GET OR 
MAKE, RATHER THAN WITH THE QUEUE FOR LIST, UPDATE AND THE LIKE. 
THUS THERE WILL NEVER BE A "“#WAITING FOR WORKER" SITUATION 
GENERATED AT LOG-ON TIME. . 


paleo ae 

A SUBSTANTIALLY HIGHER LEVEL OF CONSISTENCY CHECKING IS NOW APPLIED 
TO RECOVERY FILES, TO SCREEN OUT FILES HARMFUL TO CANDE. WHEN AN 
INVALID RECOVERY FILE IS DETECTED, THE FOLLOWING ACTIONS ARE TAKEN: 


THE CONTENTS OF THE "RECV" FILE ARE LISTED IN THE TASKFILE OF 
STACKe/CANDE, TO PERMIT DIAGNOSIS OF THE FAILURE. (PLEASE FORWARD 
ALL SUCH OUTPUT THROUGH TIO.) THE FILE IS THEN PURGED. IF A 


"TEXT" WORKFILE EXISTS (THAT IS, IF THE FILE WAS UPDATED SINCE GET 
~OR MAKE), THEN THAT FILE IS RECOVERED. THE RESULTS OF SUCH 
RECOVERY LOOK LIKE: 


#WORKFILE IS NOT NAMED: ALGOL, 347 RECORDS 
#INVALID RECOVERY FILE; NAME AND ANY CHANGES WERE LOST 


IF THERE WAS NO TEXT, OR IF ITS RECOVERY FAILED, THE MESSAGE 1S 
#INVALID RECOVERY FILE | 
COMPATIBILITY 


WHEN A WORKFILE HAS BEEN UPDATED, ITS DATA RESIDE IN A "TEXT" FILE; 
A COMPILED WORKFILE OBJECT EXISTS AS A "CODE" FILE. ALL OTHER © 
INFORMATION ABOUT AN ACTIVE WORKFILE, INCLUDING ANY CHANGES SINCE | 
THE LAST UPDATE, ARE KEPT IN THE "TANKFILE". A RECOVERY FILE IS _ 
CREATED BY TRANSCRIBING FROM THE TANKFILE THAT INFORMATION WHICH 
PERTAINS TO THE STATION WHOSE SESSION WAS ABORTED. THIS 


TRANSCRIPTION IS PERFORMED IMMEDIATELY IF CANDE WAS FUNCTIONING AT 


THE TIME OF THE ABORT (STATION DISCONNECT, OPERATOR ?QUIT, ETC.); 
IN A CATASTROPHE (EXTERNAL DS OF CANDE, SYSTEM HALT/LOAD), THE 
TANKF ILE DATA ARE TRANSCRIBED WHEN CANDE IS NEXT INITIATED. 


P 
0517 CANDE - REVISED RECOVERY MECHANISM - 09-04-73 "A°F °° 


THE 2.5 CANDE TANKFILE IS NOT COMPATIBLE WITH PRIOR RELEASES; ITS 
NAME HAS BEEN CHANGED {FROM TANKFILE/CANDE TO TANKFILE/"” (CANDE) "J 
SO 2.5 CANDE WILL IGNORE A 2.4 TANKFILE, AND VICE VERSA. CANDE CAN 
RECOVER TANKFILE DATA ONLY WHEN THE RECOVEROR HAS THE SAME 
MAXSTATIONS DEFINED AS THE LATE CREATOR; 2&.5 CANDE WILL DISPLAY 
WARNING MESSAGES AND TERMINATE IF THE TANKFILE IS NOT COMPATIBLE. 
THUS IT IS IMPORTANT TO TERMINATE CANDE NORMALLY BEFORE CHANGING 
VERSIONS OR MAXSTATIONS. (UPON NORMAL TERMINATION, 2.5 CANDE 
PURGES THE TANKF ILE.) 


ONCE THE RECOVERY DATA HAVE BEEN RECORDED IN A SEPARATE FILE, THEY 
ARE UPWARD COMPATIBLE: @.5 CANDE WILL RECOGNIZE AND ACCOMMODATE 2.4 
RECOVERY FILES; 2.4 CANDE WILL NOT RECOGNIZE 2.5 RECOVERY FILES. 


DOSI8 = CANDE - FURTHER BRUTALITY  ~ O9704z7S 

THE "BRUTAL" COMPILE TIME OPTION HAS BEEN EXTENDED AND MODIFIED: BY 
DEFAULT, IF BRUTAL IS SET, ANY CALL ON WAITANDGO WILL NOW CALL 
STACKSWAPPER, TO INCREASE THE PROBABILITY OF DETECTING ANY 
VIOLATIONS OF THE STACKSWAPPER RESTRICTIONS. TWO RUN TIME CONTROLS 
NOW PROVIDE FLEXIBILITY, USING THE ?RO AND ?SO CONTROL COMMANDS. ? 
ROUG WILL STOP FORCING WAITANDGO TO CALL STACKSWAPPER; ?RO4S WILL 
STOP FORCING GETBLK TO CALL WAITANDGO. 


DOSI9  =CANDE - IMPLEMENT DISCARD COMMAND — O97O0'z73 

A NEW CANDE COMMAND, DISCARD, HAS BEEN IMPLEMENTED TO ALLOW USERS 
TO REMOVE RECOVERY FILES THEY DO NOT WANT TO KEEP. THE KEYWORD 
"DISCARD" (MINIMUM ABBREVIATION DIS) MUST BE FOLLOWED BY THE 
RECOVERY FILE NUMBER (OR A LIST OF NUMBERS SEPARATED BY COMMAS) TO 
BE REMOVED. THIS COMMAND SPARES A USER FROM HAVING TO RECOVER A 
FILE AND THEN REMOVE HIS WORKFILE IN ORDER TO DISCARD AN UNWANTED 
RECOVERY FILE. 
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DO519 CANDE - IMPLEMENT DISCARD COMMAND - 09-04-73 


DISCARD 900,880,2e0 
DIS700 


NEW FEATURES AND DOCUMENTATION CHANGES RAGEE Se 


DO289 COBOL - STATISTICS - 04-23-73 


IT IS NOW POSSIBLE TO OBTAIN STATISTICS WHICH REVEAL THE 
CHARACTERISTICS OF A COBOL OBJECT JOB. STATISTICS ARE ACCUMULATED 
FOR A PROGRAM WHEN THE STATISTICS DOLLAR OPTION IS SET. THIS 
OPTION MAY NOT BE CHANGED AFTER THE COMPILER HAS ENCOUNTERED THE 
BEGINNING OF THE IDENTIFICATION DIVISION. WHEN THIS OPTION IS SET, 
THE COMPILER WILL INCLUDE CODE TO DETERMINE HOW MANY TIMES EACH 
PARAGRAPH IS ENTERED. AND HOW MUCH TIME IS SPENT EXECUTING THE 
INSTRUCTIONS COMPRISING EACH PARAGRAPH. 


EACH. PARAGRAPH HAS A UNIQUE NUMBER. THIS NUMBER IS PRINTED ON THE 
RIGHT-HAND SIDE OF THE COMPILER LISTING AND CORRESPONDS TO ONE LINE 
OF. OUTPUT ON THE SYSTEM SUMMARY OF THE STATISTICS. THIS SUMMARY IS 
WRITTEN ON THE JOBS DIAGNOSTIC FILE (THE FILE ON WHICH PROGRAM 
DUMPS APPEAR). A SIMPLE EXAMPLE FOLLOWS: 


PROCEDURE DIVISION. 
Pl. | 
ACTIVE CLOCK IS #0001. 
OPEN INPUT CARD=FILE. 
Pe. 
ACTIVE CLOCK IS #0002 
READ CRD AT END GO TO DONE. iy 
IF .FLD=0 THEN PERFORM ZERO-RECORD. 
PZ. 
ACTIVE CLOCK IS #0003 
MOVE 5 TO R-CLASS. 


THE OUTPUT OF THE STATISTICS SUMMARY WOULD LOOK LIKE THE FOLLOWING 
EXAMPLE : 


BLOCK _ FREQ TOTAL TIME AVG TIME 
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BLOCK FREQ TOTAL TIME AVG TIME 
MAIN 1 0.132267 0.132267 
T° 1 600 ~ 600 
2 1000 0.500000 — 500 


3 366 36600 100 


THE COLUMN LABELED BLOCK SPECIFIES THE PARAGRAPH, AS NUMBERED ON 
THE SOURCE LISTING, FOR WHICH THE LINE OF OUTPUT APPLIES. THE LINE 
LABELED MAIN IS PART OF THE TIME NECESSARY TO INITIALIZE USER DATA 
AREAS AND CONSTRUCT PART OF THE STACK. 


THE DATA LISTED UNDER THE HEADING FREQ REFLECTS THE NUMBER OF TIMES 
THE PARAGRAPH WAS ENTERED. PARAGRAPHS NEVER ENTERED ARE NOT LISTED. 


THE DATE UNDER TOTAL TIME IS THE TOTAL ELAPSED TIME SPENT 
PROCESSING THE PARAGRAPH. THE COLUMN AVG TIME IS EQUAL TO THE © 
VALUE OF TOTAL TIME DIVIDED BY FREQ. ONE SHOULD NOTE THAT TIMES | 
PRINTED: IN BOTH OF THESE COLUMNS WITHOUT A DECIMAL POINT ARE TIMES 
IN MICROSECONDS. THUS THE TOTAL TIME SPENT IN P1 WOULD BE 600 
MICROSECONDS; BUT, FOR Pe IT WOULD BE ONE HALF OF A SECOND. 


A STATISTICS SUMMARY IS PRODUCED AT END OF JOB, WHEN THE PROGRAM IS 
DS-ED, OR WHEN THE EXCEPTION EVENT FOR THE JOB IS CAUSED. IF A 
SUMMARY IS DESIRED PART OF THE WAY THROUGH EXECUTION THE EXCEPTION 
EVENT CAN BE CAUSED BY ENTERING A HI MESSAGE AT THE CONSOLE. 


ONE MUST OBSERVE A FEW FACTS ABOUT THE METHOD USED TO COLLECT 
STATISTICS TO AVOID MISINTERPRETATION OF THE DATA. FIRSTLY, THE 
TIMES ACCUMULATED ARE ELAPSED TIMES. THEREFORE, THEY REFLECT THE 
TIME NEEDED TO HANDLE PRESENCE BIT INTERRUPTS, 1/0 INTERRUPTS, AND 
POSSIBLY, TIME SPENT IN OTHER PROCESSES. ALSO, THE TIMING DOES NOT 
CEASE UPON ENTERING THE MCP (READ, WRITE, ETC) OR USING IPC (CALL, 
PROCESS, CONTINUE, ETC). THE PERFORM STATEMENT, HOWEVER, DOES STOP 
TIMING AND BEGIN TIMING THE PERFORMED PARAGRAPH, RESUMING THE 
TIMING OF THE PERFORMING PARAGRAPH UPON EXIT FROM THE PERFORM RANGE. 
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BOSS COBOL - ERROR PROCEDURES -—- 06-c4-73 


THIS CHANGE ALLOWS THE APPLICATION OF STANDARD ERROR PROCEDURES ON 
REMOTE FILES. WHEN THE TIMELIMIT FOR A READ IS EXCEEDED, THE USE 
PROCEDURE WILL BE EXECUTED. 


D0370 COBOL - COBOL SORT OR MERGE STATEMENT = 06-24-73 

THIS CHANGE IMPLEMENTS THE ABILITY TO GENERATE OPTIMIZED COMPARE 
PROCEDURES USED BY COBOL SORT AND MERGE VERBS. NORMALLY , THE 
AMOUNT OF CODE PRODUCED FOR THIS PURPOSE IS REDUCED AND IN SOME 
CASES, ELIMINATED ENTIRELY BY PASSING INFORMATION TO THE SORT 
INTRINSIC TO ALLOW THE COMPARISONS TO BE DONE WITHIN THE INTRINSIC. 
THIS CHANGE CAN RESULT IN SUBSTANTIALLY DECREASED SORT TIMINGS. 
THE COMPILER WILL SCAN ALL SORT KEYS BEFORE EMITTING CODE FOR THE 
COMPARE PROCEDURE. WHEN POSSIBLE, ADJACENT KEYS WILL BE 
CONCATENATED AND OVERLAPPING KEYS WILL BE TRUNCATED OR ELIMINATED. 
TO USE THIS NEW ABILITY TO GREATEST ADVANTAGE THE FOLLGWING ARE 
SUGGESTED (IN ORDER OF IMPORTANCE). 


1. USE ONLY ONE KEY WHICH IS A WORD ALIGNED COMPUTATIONAL 
DATA ITEM. 


2. WHEN SIGNED NUMERIC KEYS ARE USED, MAKE THEM COMPUTATIONAL 
AND PREFERABLY WORD ALIGNED. 


3. WHEN MULTIPLE KEYS ARE USED, MAKE THEM ADJACENT IN THE 
RECORD AND ALL ASCENDING OR ALL DESCENDING. 


4. DISPLAY-1 NUMERIC CAN BE PROCESSED AS WELL AS EBCDIC 
NUMERIC BUT DISPLAY-1 NON-NUMERIC SHOULD BE TRANSLATED TO | 
EBCDIC. 


THE QUICKEST SORTS WILL OCCUR WHEN THE COMPARISONS ARE DONE WITHIN 
THE SORT AND THIS CAN ONLY HAPPEN WHEN THE SORT KEY MAY BE COMPARED. 
BY A SINGLE COMPARE. PROCESSOR AND ELAPSED TIME REDUCTIONS OF 50% 


DO370 COBOL - COBOL SORT OR MERGE STATEMENT - o6-24-753°0F 2 


OR GREATER CAN RESULT FROM TAKING ADVANTAGE OF THIS IMPROVEMENT . 
TO UTILIZE THIS NEW FEATURE, IT IS NECESSARY TO COMPILE THE PROGRAM 
(S) CONAINING SORT OR MERGE STATEMENTS WITH OPTIMIZE SET. WHEN 
OPTIMIZE 1S RESET THE PREVIOUS COMPARE PROCEDURE CODE WILL BE 
EMITTED EXACTLY AS THE MARK 2.4 LEVEL CODE. NO PROBLEMS ARE 
ANTICIPATED FOR THE IMPROVED COMPARE PROCEDURE, HOWEVER, IF YOU 
BELIEVE THE NEW METHOD DOES NOT RESULT IN CORRECTLY SEQUENCED 
OUTPUT YOU CAN RECOMPILE WITH OPTIMIZE RESET AND OBTAIN THE OLD 
COMPARISON METHOD. 


PLEASE REFER TO SYSTEM NOTES FOR THE SORT FOR ADDITIONAL 
INFORMATION. . 


NOTE: IT WILL BE NECESSARY TO UTILIZE A 2.5 LEVEL MCP TO TAKE 
ADVANTAGE OF THE SORT IMPROVEMENTS. 


DOW57 COBOL = FLOATING POINT IMPLEMENTATION = 09-04-73 
FLOATING POINT ARITHMETIC HAS BEEN IMPLEMENTED. A DATA ITEM MAY BE 
DESIGNATED AS FLOATING POINT BY THE "USAGE" CLAUSE. FOR SINGLE 
PRECISION FLOATING POINT, "USAGE IS COMP-4" SHOULD BE WRITTEN, AND 
FOR DOUBLE PRECISION, “USAGE IS COMP-5". NO PICTURE CLAUSE MAY BE 
SPECIFIED. A FLOATING POINT ITEM MAY. BE USED LEGALLY ANYWHERE A 
"COMP" ITEM CAN BE USED. IN ORDER TO FACILITATE THE USE OF THIS 
NEW COMPUTATIONAL USAGE, THE COMPILER ALSO WILL ACCEPT NUMERIC 
LITERALS OF THE FORM: 


<NUMBER>E<EXPONENT > 


THE <EXPONENT> MUST BE AN INTEGER AND MAY BE SIGNED. NO SPACE MAY 
BE IMBEDDED IN THE LITERAL. A DECIMAL POINT MUST APPEAR IN THE 
MANTISSA. 


EXAMPLES: 


-12.347E3 
3.13E-14 
1247.E-4 
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DOY58 COBOL - CLOSE WITH CRUNCH —- 07-29-73 


Bee, eee? eee ee ee eee 

THIS PATCH IMPLEMENTS THE CLOSE CRUNCH ACTION. "CRUNCH" SHOULD BE 
ADDED TO THE LIST OF OPTIONS AVAILABLE TO A FORMAT ONE CLOSE 
STATEMENT . 


CRUNCH IS NOW A RESERVED WORD. 


DOHSS = COBOL = «CODE FILE - 08719775 

THIS CHANGE DECLARES THE COMPILER CODE FILE TO HAVE A ROW SIZE OF 
180 SEGMENTS. IT ALSO PROVIDES FOR A CLOSE WITH CRUNCH TO RETURN 
TO THE SYSTEM ANY DISK SPACE NOT ACTUALLY USED FOR OBJECT CODE. 


ee ees eee eee eee ee 
THIS CHANGE WILL ALLOW COBOL REPORT WRITER PROGRAMS TO CONTAIN MORE 
THAN 128 SUM COUNTERS. 


DONG1 = =COBOL = SELECT STATEMENT = 08719773 

THIS CHANGE ELIMINATES THE "ACCESS IS DIRECTED" AND "ASSIGN TO 
PACKED" OPTIONS FROM THE SELECT STATEMENT. THE WORDS DIRECTED AND 
PACKED ARE NO LONGER RESERVED WORDS. THESE OPTIONS WERE NEVER 
IMPLEMENTED. 


DONGE COBOL = SINGLE SPACE LISTING - 08-26-73 

THIS CHANGE CAUSES THE SINGLE OPTION TO BE SET BY DEFAULT. 
RESETTING SINGLE WILL PROVIDE A DOUBLE SPACED LISTING. IF DEFAULT 
DOUBLE SPACE LISTING IS DESIRED THE COMPILER SHOULD BE RECOMPILED 


DOUG2 COBOL - SINGLE SPACE LISTING - 08-26-73 ACE “Ds 


WITH THE USER OPTION LISTDOUBLE SET. 


DOYS COBOL - MODEL 1 - 08-26-73 
THIS CHANGE ELIMINATES THE MODEL I - MODEL II DISTINCTION. MODEL 
II CODE IS GENERATED IN ALL CASES NOW. 


Daner, {COBOE, VCOBOE REPORT ares: @ ceases) 
THIS CHANGE IMPLEMENTS THE USE OF TODAYS-DATE AS A SOURCE FIELD IN 
REPORT WRITER. 


poses COBOL = IMBEDDED QUOTES = 097e3773 

BEGINNING ON THE 2.6 RELEASE, THE HANDLING OF IMBEODED QUOTES 
WITHIN LITERAL STRINGS WILL CHANGE TO CONFORM WITH THE NATIONAL 
STANDARD, WHICH STATES: 


“EACH EMBEDDED PAIR OF CONTIGUOUS QUOTATION MARKS REPRESENTS 
A SINGLE QUOTATION MARK CHARACTER". 


FOR EXAMPLE: THE LITERAL STRING """A""B""" WILL BE CONSIDERED 
TO BE “A"B" IN AN OUTPUT FORM, AND WILL HAVE A LENGTH OF FIVE 
CHARACTERS. 


DO526 COBOL - ENHANCED DMS - 05-19-73 


IN ORDER TO ACCESS ENHANCED DATA MANAGEMENT FUNCTIONS IN COBOL THE 
COMPILER MUST BE COMPILED WITH A 


$ SET BDMS 
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DO527 COBOL - COBOL INSTALLATION INTRINSICS - 08-26-78 


eee? EOBOL, 12 COBOL. INSTALLATION INTRINSICS: = OGe6-73 

COBOL PROGRAMS COMPILED AT LEVEL TWO MAY BE BOUND - INTO THE 
INTRINSIC FILE IF THEY ARE COMPILED WITH "INTRINSICS" SET. AT 
PRESENT THE USE OF SUCH INTRINSICS IS RESTRICTED TO NON-COBOL 
PROGRAMS, SINCE THEY ARE ANALOGOUS TO ALGOL UNTYPED PROCEDURES. 
THE GLOBAL PHRASE IS NOT ALLOWED IF INTRINSICS IS SET. 


D0528 COBOL = SYNCHRONIZE CLAUSE - 09-16-73 

IN A RECORD DESCRIPTION, WHEN AN ITEM IS NOT SUBORDINATE TO AN ITEM 
HAVING AN OCCURS CLAUSE, THE SYNCRONIZED CLAUSE CAUSES THE ITEM TO 
BE ALIGNED TO A WORD BOUNDARY, REGARDLESS OF ITS USAGE OR THE USAGE 
OF AN Ol ITEM. WHEN AN ITEM IS SUBORDINATE TO AN ITEM HAVING AN 
OCCURS CLAUSE, THE SYNCHRONIZED CLAUSE IS EFFECTIVELY IGNORED, AND 
THE ITEM .IS ALIGNED TO THE NEXT CHARACTER BOUNDARY CONSISTENT WITH 
ITS USAGE. A WARNING MESSAGE IS NOW PRINTED IN THIS CASE. 


DOste COBOL = OPTIMIZE RESET WITH DM & MONIT - 09-23-73 

ON 2.5 COBOL THE DOLLAR OPTION "OPTIMIZE" IS INITIALIZED TO TRUE. 
PROGRAMS USING MONITOR OR TWO-DIMENSIONAL DIRECT RECORD AREAS WILL 
HAVE TO EXPLICITLY RESET THIS OPTION. PROGRAMS USING DATA 
MANAGEMENT WILL BE GIVEN A WARNING MESSAGE STATING THAT THE 
OPTIMIZE OPTION HAS BEEN RESET IMPLICITLY. 


NEW FEATURES AND DOCUMENTATION CHANGES ie ae 


CONTROLLER 


DO293 CONTROLLER - DM — DEFAULT MONITOR TITLE -—- 05-07-73 


THE "DM" INPUT MESSAGE TO THE CONSOLE IS A METHOD OF HANDLING 
DEFAULT TITLES TO DESIGNATE WHICH DATA-MANAGEMENT MONITOR IS TO BE 
EXECUTED AT DATA-BASE OPEN TIME. THE SYNTAX IS: 


DM<ETX> INTERROGATE CURRENT DEFAULT MONITOR 
ELIE. 
DM-<ETX> CHANGE DEFAULT MONITOR TITLE BACK TO 


THE COLD START VALUE OF SYSTEM/DMS8700. 


DM<MONITTOR TITLE><ETX> CHANGE DEFAULT TITLE TO <MONITOR 
TITLE> E.G., SYSTEM/FM670G0ALL. 


THE RESPONSE TO ANY OF THESE INPUTS WILL BE EITHER: 
REQUIRED LOCK IN USE 

OR 
DM MONITOR: <CURRENT MONITOR TITLE> 


DO29S6 CONTROLLER — INPUT MESSAGES BREAK AND WHY —- 05-07-73 


THIS PATCH IMPLEMENTS TWO NEW FEATURES: 
1. <MIX> WHY (SYNONYMS WY, Y) 


THIS WILL RETURN NAME, PRIORITY, RSVP, DISPLAY, STACK 
STATE, LEGAL..RESPONSES TO RSVP, JOB CLASS, ETC, 


2. BREAK (SYNONYM: BRK) 


THIS WILL FLUSH THE QUEUE CONTAINING MESSAGES TO BE 
DISPLAYED. - 


DO298 CONTROLLER - "EI" CHANGES - 05-07-73 ane See 


DO2388 CONTROLLER - "EI" CHANGES - 05-07-73 


EI WILL WORK AS IT OID PREVIOUSLY BUT NOW ALLOWS THE FOLLOWING 
SYNTAX: 


[es El? THIS WILL INDICATE THE CURRENT SETTING 
ee EE THIS WILL SET THE INTERRUPT 
a> BL THIS WILL RESET THE INTERRUPT 
DO308 CONTROLLER - CHANGE DISPLAY FORMAT OF OT - 05-07-73 


WHEN THE OT MESSAGE IS ENTERED, THE SYSTEM DISPLAYS THE FOLLOWING 
MESSAGE ON THE CONSOLE: 


<STACK#> STACK CELL <CELL#> = <TAG><CONTENT OF THAT CELL 
IN HEX><MESSAGE > 


<MESSAGE> HAS ONE OF THE FOLLOWING THREE FORMATS: 


1. "NOT A SINGLE OPERAND" IF TAG > ZERO 
2. "THIS DECIMAL NUMBER > 549755813887" IF CONTENT > MAXINTEGER 
3. "<CONTENT OF THAT CELL IN DECIMAL> -- DECIMAL" 


DO318 CONTROLLER - ERRORS IN GET-SET STATUS ~ 06703773 

CERTAIN ERROR CONDITIONS RETURNED BY GETSTATUS AND SETSTATUS 
INDICATE THAT ONE OF THE PARAMETERS WAS WRONG, THAT IS, THAT THE 
FORMAT OF THE CALL WAS INCORRECT. SOME OF THE CALLS ON GETSTATUS 
AND SETSTATUS WERE NOT CHECKING FOR THESE ERROR CONDITIONS. IF ONE 
IS DETECTED ITS NUMBER WILL NOW BE DISPLAYED. 


EXAMPLE : 


INVALID CASE # 


DO4336 CONTROLLER - CONSOLE MSG FOR Q-DS-ED JOBS - 06-24-73 


IF A JOB IS NOT RUN BECAUSE IT DID NOT FIT IN A QUEVE, THE MESSAGE 
"JOB FAILED QUEVE INSERTION" WILL BE DISPLAYED AND THE JOB WILL 
SHOW AS "Q-DS" IN THE COMPLETED TABLE. NOTE THAT THIS CAN OCCUR A) 
WHEN A JOB FIRST COMES INTO THE SYSTEM, B) AFTER A HALT/LOAD, OR C) 
AFTER AN EQ. 


IF A JOB IS NOT RUN BECAUSE IT IS EXPLICITLY DS-ED FROM ITS QUEUE 
BY THE OPERATOR, THE MESSAGE "OPERATOR DS-ED" WILL BE DISPLAYED AND 
THE JOB WILL SHOW AS "O-DS" IN THE COMPLETED TABLE. 


IF A JOB HAS AN ERROR WHEN IT IS STARTED UP, SUCH AS AN INVALID 
USER CODE NOT DETECTED AT WORK FLOW LANGUAGE COMPILE TIME, THE 
MESSAGE “JOB ATTRIBUTE ERROR" WILL BE DISPLAYED AND THE COMPLETED 
TABLE WILL SHOW "A-DS". 


JOBS FLUSHED BY PQ WILL STILL NOT BE SHOWN SINCE IT IS ASSUMED THAT 
COMMAND IS ONLY USED TO REMEDY SOME GROSS OPERATIONAL ERROR. 


LOG FORMAT OF JOB ABORT RECORDS 
WHEN A JOB IS DS-ED FOR ANY OF THE REASONS DESCRIBED ABOVE , IT WILL 
GET A LOG RECORD. THIS RECORD HAS THE FOLLOWING FORMAT: 


MAJOR TYPE = 1 

MINOR TYPE = 7 “LOGJOBABORT" 

WORDS 0-3 AS USUAL 

WORD 4 [31:8] WHY DS-ED: 
1. QUEUE INSERTION ERROR 
2. JOB ATTRIBUTE ERROR 

[23:16] USED, IF ATTRIBUTE ERROR, 

TO GIVE ATTRISUTE NUMBER 
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DOS37 CONTROLLER = CONSOLE MESSGE FOR NEW JOBDESC - 06-24-73 
IF A NEW JOBDESC IS CREATED, "A NEW JOBDESC CREATED" MESSAGE WILL 
BE DISPLAYED ON THE CONSOLE. 


BUSZE:  CONTROERER? 2) TRUNCATE <BO INET TES SAGE. “ECG ens 

WHEN REQUESTING A PD, THE IDENTIFIERS (EACH) MUST BE 17 CHARACTERS 
OR LESS, OTHERWISE THE SYSTEM WILL UNCONDITIONALLY TRUNCATE TO 17 
CHARACTERS AND DISPLAY THE MESSAGE, “NAME TOO LONG - TRUNCATED TO 
17 CHRS". 


DO0339 CONTROLLER - RESTRICT LOGICAL QUEUE NUMBER - 06-24-73 


THE MAXIMUM QUEUE NUMBER WHICH CAN BE USED IN AN MQ COMMAND IS 1023. 


DO371 CONTROLLER = UNIT QUEUE - 06-24-73 
THE FUNCTION "CLASS ASSIGNMENT BY ORIGINATING UNIT" IS. NOW 
IMPLEMENTED. 


1. THE UQ MESSAGE PROVIDES (A) ASSIGNMENT, (B) INTERROGATING AND 
(C) DELETING FUNCTIONS. 


e. ALL JOBS INITIATED THROUGH A UNIT WHICH HAS UNIT QUEUE 
ASSIGNMENT WILL GO THROUGH THAT PARTICULAR QUEUE. IF THE JOB 
HAS CLASS ASSIGNMENT IN ITS CONTROL CARD, THE SYSTEM WILL CHECK 
THE CLASS OF THE JOB AGAINST THE CLASS OF THE UNIT (IF THAT UNIT 
HAS CLASS ASSIGNMENT). IF CLASS IS NOT COINCIDENT, THE JOB WILL 
BE THROWN AWAY. 


3. IF THE QUEUE FOR A UNIT WHICH HAS CLASS ASSIGNMENT WAS EQ-ED, 
ALL JOBS THROUGH THAT UNIT WILL BE THROWN AWAY. 


D0371 CONTROLLER - UNIT QUEUE - 06-24-73 Baee, lee 


ns number 


et a device ————-w» unit number list 


oer 
CONSOLE RESPONSE 
1. ASSIGNMENT CINPUT UQ <DEVICE><UNIT NUMBER><NUMBER> ) 
A. QUEUE X EXISTS 
DISPLAY: QUEUE FOR UUNNN IS X 
NOTE: UU = UNIT TYPE 
NNN = UNIT NUMBER 
X = QUEUE NUMBER 
EXP. QUEUE FOR CROle IS 3. 
B. QUEUE X DOES NOT EXIST 
1) UNIT HAS QUEUE ASSIGNMENT ‘ 
DISPLAY: QUEUE X DOES NOT EXIST 
QUEUE FOR UUNNN IS X1 
2) UNIT DOES NOT HAVE QUEUE ASSIGNMENT 
DISPLAY: QUEUE X DOES NOT EXIST 


2. INTERROGATION (INPUT UQ <DEVICE><UNIT NUMBER>) 
A. UNIT DOES NOT HAVE QUEUE ASSIGNMENT 
NO DEFAULT FOR UUNNN 
B. UNIT HAS QUEUE ASSIGNMENT 
QUEUE FOR UUNNN IS X 


3. DELETING CINPUT UQ <DEVICE><UNIT NUMBER>>? 


D0371 CONTROLLER - UNIT QUEUE - 06-24-73 se see 


DISPLAY: NO DEFAULT FOR UUNNN 


4. GENERAL REQUEST (INPUT UQ) 
A. NO UNIT QUEVE ASSIGNMENT AT ALL 
DISPLAY: NO UNIT QUEUE ASSIGNMENTS 
B. AT LEAST ONE UNIT QUEUE ASSIGNMENT 
DISPLAY: QUEUE FOR UUNNN IS xX 


00373 CONTROLLER = QF MESSAGE DISPLAY ACTIVE MIX - 07-08-73 
WHEN AN QF MESSAGE IS ENTERED, THE ACTIVE MIX COUNT WILL ALSO BE 
DISPLAYED IF THE ACTIVE COUNT IS NOT ZERO. 


Be eee oe ete aE BO Eee) aye alas 
A JOB QUEUE WHICH HAS ACTIVE JOBS ASSOCIATED WITH IT MAY NOT BE 
ELIMINATED. AN ATTEMPT TO DO SO WILL PRODUCE THE ERROR MESSAGE: 


“QUEUE HAS ACTIVE JOBS" 


DOS99 CONTROLLER == DISK PACK CONTROLLER CHANGES — 06-24-73 
THIS DNOTE DISCUSSES THE CHANGES THAT HAVE BEEN MADE IN CONTROLLER, 
SETSTATUS, AND GETSTATUS TO IMPROVE THE DISK PACK OPERATOR 
INTERFACE. 


THE OPERATORS CONTROL OVER THE DISK PACK SUBSYSTEM HAS BEEN 
ENHANCED BY PUTTING MORE INFORMATION IN THE PER PK AND OL PKUUU 
DISPLAYS, PROVIDING A COMMAND TO RELABEL A PACK WITHOUT DESTROYING 
THE FILES ON IT, IMPLEMENTING DISK PACK VOLUME PROTECTION VIA THE 
OWNERS-NAME VOLUME LABEL FIELD, AND GIVING THE OPERATOR CONTROL 
OVER THE WRITE LOCKOUT STATUS FOR EACH PACK. 


P 
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TWO OPERATOR DISPLAYS WILL BE PROVIDED: 


1. THE PER PK DISPLAY, WHERE EACH PACK IS LIMITED TO ONE LINE. 
SINCE, IN CERTAIN CASES, THERE IS NOT ROOM FOR ALL OF THE 
INFORMATION ON ONE LINE, ONLY THE MOST IMPORTANT ITEMS 
WILL BE DISPLAYED. 


2. THE OL PKNN DISPLAY, WHERE THE ENTIRE SCREEN IS AVAILABLE 
FOR THE PACK IN QUESTION. IN THIS CASE THE COMPLETE 
STATUS OF THE UNIT CAN BE DISPLAYED. 


BELOW ARE DESCRIBED THE DISPLAYS AS THEY WILL APPEAR ON THE SCREEN 
(FROM LEFT TO RIGHT). 


1. THE UNIT NUMBER. 


2. CODE FOR TYPE OF PACK (B = NATIVE MODE BASEPACK, C = 
NATIVE MODE CONTINUATION PACK, I = INTERCHANGE MODE PACK) .. 


3. ASTERISK IF UNIT IS NOT WRITE LOCKED OUT. 
YU. VOLUME SERIAL NUMBER ENCLOSED IN BRACKETS. 


5. IF PACK IS NATIVE CONTINUATION PACK, THE SERIAL NUMBER OF 
THE BASEPACK IS PRECEDED BY A COLON. 


6. IF PACK IS A CONTINUATION PACK AND’ THE © BASEPACK IS 
MOUNTED, THE UNIT NUMBER OF THE BASEPACK IS PRECEDED BY 
ANOTHER COLON. 


7. IF A UNIT IS ASSIGNED TO AN MCP FUNCTION, THE STACK NUMBER 
OF THE INDEPENDENT RUNNER IS ENCLOSED IN PARENTHESES. 


THIS COMPLETES ALL OF THE STANDARD INFORMATION THAT IS ALWAYS 
DISPLAYED IF AVAILABLE. EXCEPT FOR POINT SEVEN, WHICH NORMALLY 
ONLY APPLIES FOR A FEW SECONDS (E.G., DURING READPACKLBL), 27 
SPACES HAVE BEEN USED. FOR THE FOLLOWING ITEMS, ONLY THE FIRST 
APPLICABLE ITEM IS DISPLAYED FOR THE PER PK LINE (FOR THE OL PKNN 
CASE, ALL APPLICABLE ITEMS ARE DISPLAYED). 


DO339 CONTROLLER - DISK PACK CONTROLLER CHANGES) - o6-2uh 4 SE oP 


8. IF THE UNIT WAS CLEARED (CL PKNN) OR THE OPERATOR REPLIED 
DS TO A WRONG PK MESSAGE, THE UNIT IS IN THE "BLASTED" 
STATE AND “BLASTED" IS DISPLAYED. 


9. IF THE UNIT IS NOT READY AND IT IS STILL IN USE BY A 
PROGRAM, "NOT READY" IS DISPLAYED. 


10. IF THE UNIT HAS THE SAME SERIAL NUMBER OF ANOTHER PACK 
THAT IS ALREADY MOUNTED, "DUP SERIAL" IS DISPLAYED. 


11. IF THE UNIT IS SAVED, "SAVED" IS DISPLAYED. 


le. IF THE UNIT HAS BEEN CLOSED BUT IT IS STILL READY, 
"CLOSED" IS DISPLAYED. 


13. IF THE PACK DOES NOT HAVE A VALID VOLUME LABEL (E£.G., NO 
PACKNAME), "UNLABELLED" IS DISPLAYED. 


14. IF THE PACK HAS NOT BEEN IV-ED, "UNINITIALIZED" IS 
DISPLAYED. 

15. IF THE PACK HAS BEEN PURGED (PG COMMAND), "SCRATCH" IS 
DISPLAYED. 


16. IF THE PACK IS LABELLED AND HAS A VALID PACKNAME, THE 
PACKNAME IS DISPLAYED. 


BEESBEE JERS: 

THE NEW VERB LB IS USED TO CHANGE THE PACKNAME, VOLUME SERIAL 
NUMBER, AND/OR THE NAME OF THE OWNER WITHOUT DESTROYING OR DAMAGING 
ANY FILES ON THE PACK. (USEFUL FOR CREATING BACKUP PACKS, ETC.) 
THE LB VERB TAKES THE SAME OPERAND STRING AS THE RC AND IV VERBS. 


PACK PROTECTION: 


THE OPERAND OWNER = NAME MAY NOW BE USED (WHERE THE NAME HAS FROM — 
ONE TO 14 CHARACTERS) FOR THE RC, IV AND LB VERBS. THIS 

INFORMATION WILL BE INSERTED INTO THE APPROPRIATE VCL1 LABEL FIELD 
WHENEVER SPECIFIED. SUBSEQUENTLY, IF ANY ATTEMPT IS MADE TO IV, 
RC, LB OR PG A PACK WITH A NON-BLANK OWNERS NAME, THE OPERATOR WILL 
BE NOTIFIED AND WILL BE REQUIRED TO AUTHORIZE THE REQUEST. THIS 
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WILL HELP PREVENT OPERATOR MISTAKES (E.G., WRONG UNIT NUMBER FOR 
AN RC COMMAND) AND WILL ALSO PROTECT AGAINST MALICIOUS SETSTATUS 
CALLS FROM DCALGOL PROGRAMS. TO OK SUCH AN RL THE OPERATOR MUST 
ENTER <MIX NUMBER>OK. IF HE DS-ES THE RC, THE PACK MUST BE CLOSED 
AND READIED BEFORE FURTHER USE. IF IT IS DESIRED TO REMOVE THE 
OWNER ATTRIBUTE OF THE BACK , THE BACK SHOULD BE RC-ED WITH OWNER=" 

| e p 


AR TTE EpesOuls 

THE OPERATOR WILL NOW BE ABLE TO SPECIFY THE INTERNAL WRITE ENABLE/ 
DISABLE STATE OF DISK PACKS. GETUSERDISK WILL GIVE A SECT REQ 
MESSAGE IF A REQUEST IS MADE FOR A SPACE ON A WRITE LOCKED OUT PACK. 
THE OPERATOR WILL BE ABLE TO CHANGE THE WRITE LOCKOUT STATUS OF THE 
UNIT (CAS*REFLECTED BY THE ASTERISK IN THE PER PK DISPLAY) WITH THE 
COMMAND : 


MODE PKNN IN 
OUT 


Dee Oe 5 Ee ee NOT None TE ee eek a Ber lese 


EP IS NOT ALLOWED WHILE AP IS RUNNING. THE CONSOLE WILL DISPLAY 
"AP 1S SET" INSTEAD OF ELIMINATING THE PRINT QUEUE. 


DOYeS5 CONTROLLER - EXPANDED DIR SYNTAX - 08-12-73 


THE DIR SYNTAX HAS BEEN EXPANDED TO ALLOW A USERCODE AND PASSWORD 
TO BE ASSOCIATED WITH THE EXECUTION. 


~NEW SYNTAX: 


DIR [ (<USERCODE >/<PASSWORD>) J {[- / <INTEGER> ] 
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DOY65 CONTROLLER - IMPROVED DIAGNOSTIC FACILITIES — 07-08-73 


MONITOR 


THE CO (CONTROLLER OPTIONS) MESSAGE ALLOWS OPTIONS WHICH ARE 
MEANINGFUL ONLY TO THE CONTROLLER TO BE EXPLICITLY SET OR RESET. 
THE CONTROLLER OPTIONS ARE: 


ERRORDP WHEN SET ANY ERROR WILL RESULT IN A PROGRAM DUMP. ANY 
CONDITION WHICH WOULD RESULT IN A MEMORY DUMP BY THE 
CONTROLLER WILL ALSO RESULT IN A PROGRAM DUMP. RESETTING 
THIS OPTION WILL CLOSE THE PRINTER BACKUP FILE FOR 
SUBSEQUENT PRINTING. 


MONITOR WHEN SET STATEMENTS WITHIN THE CONTROLLER MAY BE 
CONDITIONALLY EXECUTED. THE OPTION IS USED FOR DEBUGGING 
AND IN THE STANDARD RELEASE THIS OPTION WILL HAVE NO 
EFFECT. _ 


DO4Y66 CONTROLLER - OVERALL MIX LIMITS - 07-08-73 


ee MIXLIMIT 


number 


DO46S CONTROLLER - OVERALL MIX LIMITS = 07-08-73 [*°F °° 


THIS WILL SET OR DISPLAY THE OVERALL MIX LIMIT. WHEN A MIXLIMIT IS 
SET THIS IS THE LIMIT USED WHEN INTRODUCING NEW JOBS INTO THE 
SYSTEM; THIS IS THE TOTAL NUMBER OF JOBS WHICH MAY BE INTRODUCED 
REGARDLESS OF THE MIXLIMIT AS SET ON EACH QUEVE. SETTING MIXLIMIT 
EQUAL TO ZERO WILL ALLOW NO JOBS TO BE RUN. THE LIMITS SET ON EACH 
JOB QUEVE NEED NOT BE CHANGED. THE RESPONSE TO THIS MESSAGE WILL 
SHOW THE QUEUE CLASS, THE ACTIVE COUNT, THE MIXLIMIT, AND THE 
NUMBER OF JOBS QUEVED FOR EVERY JOB QUEUE. IF A DEFAULT QUEUE HAS 
BEEN SET THE LETTER "D" WILL APPEAR IN THE LEFT MARGIN BESIDE THAT 
QUEVE. MIXLIMIT MAY BE USED IN THE ADM TIME MODE. 


THE COMMAND "MIXLIMIT" IS ALSO A VALID ADM OPTION FOR TIME (BUT NOT 
EVENT) DISPLAYS. 


DONE? “CONTROLLER. 2) BSRIETERBE AOSOCTATLON: »2 D72es7i2 

THE PA (PERIPHERAL ASSOCIATION) COMMAND IS USED TO ASSOCIATE INPUT 
DEVICES AND OUTPUT DEVICES. THE UNITS HAVE TO BE SEEN BY THE 
SYSTEM AT RUN TIME. HOWEVER, CURRENT IMPLEMENTATION ONLY HAS 
CONTROL OVER LINE-PRINTER AND CARD-PUNCH AS OUTPUT. THE INPUT UNIT 
HAS TO BE SEEN BY THE SYSTEM AS THE ORIGINATING UNIT. IF THERE IS 
NO PA ASSOCIATED FOR A CERTAIN UNIT, BY DEFAULT THE OUTPUT (OF THE 
JOB THROUGH THAT UNIT) WILL GO TO ANY LINE-PRINTER OR CARD-PUNCH. 


IF THE UNIT HAS PA ASSOCIATED, THE OUTPUT OF THE JOB THROUGH THAT 
UNIT CAN ONLY GO TO THE SPECIFIED LINE-PRINTER OR CARD-PUNCH. NOTE 
THAT IF AN INPUT UNIT HAS BEEN PA-ED BUT HAS NO APPROPRIATE OUTPUT 
DEVICES ASSOCIATED, THEN BACKUP FILES FOR JOBS INITIATED FROM THAT 
UNIT MAY ACCUMULATE ON DISK WITHOUT BEING PRINTED OR PUNCHED. 


28 PA ay 
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PA device -— unit number list 


ae E 3 
device ™ unit number = device -—™ unit number 
list list 
+ 


EXAMPLE ONE: 


PA CR10 = LPle, LP13, CPed 


ALL THE JOBS THROUGH CARD READER 10 CAN ONLY BE PRINTED OUT 
ON LINE-PRINTER 12 OR’ 13 OR PUNCHED OUT ON CARD-PUNCH e0., 
EVEN IF THE SYSTEM HAS LP15, LP16, OR CP18, CPel, CPee. 


EXAMPLE TWO: 


AFTER THE FIRST EXAMPLE HAS BEEN DONE, THE NEW MESSAGE 
PA CR1O = -LP13 


IS ENTERED. THIS WILL LIMIT THE OUTPUT DEVICES FOR CR10 TO 
BE LP12@ AND CP20 ONLY. NO JOB THROUGH CRI0O CAN BE PRINTED 
OUT ON LPle. 


: 7 
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IF AFTER EXAMPLE ONE HAS BEEN DONE THE MESSAGE PA-CR10 IS 
ENTERED, THE SYSTEM WILL FROM NOW ON ASSUME THE JOBS THROUGH 
CR10 CAN BE PRINTED OUT ON ANY EXISTING LINE-PRINTER OR 
PUNCHED OUT ON ANY EXISTING CARD-PUNCH. 


DO4W75 CONTROLLER 


ADM EVENT PRINTLABE = US-le-G3 


NEW ADM EVENT TYPE: 


ADM a EVENT ——s~ PRINTLABEL 
+ 


SAVEFACTOR 
SERIALNO 
TASKID 
TASKNO 
TIME 
TITLE. 
UNITNO 
VERSION 
THIS ADM EVENT TYPE IS USED TO PRODUCE TAPE LABELS IN ANY DESIRED 


FORMAT. THESE LABELS MAY BE PRINTED DIRECTLY ON THE GUMMED LABELS 
TO AVOID OPERATIONAL MISTAKES. THE QUOTED STRING IS USED TO INSERT 
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A LITERAL TO IDENTIFY THE VARIOUS DATA ITEMS. THE / WILL CAUSE A 
CARRAGE RETURN. THE NUMBER FOLLOWING THE NAMED DATA ITEMS 
SPECIFIES THE MAXIMUM SIZE WHICH MAY BE USED TO CONTAIN THAT DATA. 
IF THE DATA OF AN ALPHA TYPE ITEM EXCEEDS THE FIELD WIDTH THEN THE 
RIGHT MOST CHARACTERS WILL BE TRUNCATED. IF THE DATA OF A NUMERIC 
TYPE ITEM EXCEEDS THE FIELD WIDTH THEN THE FIELD WILL BE FILLED 
WITH "*"., 


THE FORMATTING SPECIFICATION MAY BE EXTENDED BY. USING THE "+" 
FOLLOWING THE WORD ADM. AFTER THIS ADM TYPE HAS BEEN SET UP THE 
STATE OF THE AUTOMATIC DISPLAY IS MARKED AS "STOPPED". THIS ALLOWS 
THE PROPER FORMS TO BE INSERTED PRIOR TO RECEIVING ACTUAL DATA. TO 
TEST THE FORMATTING SPECIFICATION "PRINTLABEL" MAY BE ENTERED. 
THIS WILL PRODUCE THE TAPE LABEL FILLING ALL NUMERIC ITEMS WITH "N" 
AND ALL ALPHA ITEMS WITH "A". ONCE THE FORMATTING HAS BEEN 
CORRECTLY ESTABLISHED ADM GO WILL ACTIVATE THE PRINTING OF TAPE 
LABELS: EACH. LIME A TAPE FILE tS~-CLOSED. 


IF NOTHING FOLLOWS THE WORD PRINTLABEL THEN A DEFAULT SETTING WILL 
BE SET UP AS DEFINED IN THE CONTROLLER. THIS DEFAULT MAY BE 
CHANGED BY THE INSTALLATION. 


NEW FEATURES AND DOCUMENTATION CHANGES Ree Ae. 


DATACOM 


DO312e MCP-DATACM — NEW QUEVE ATTRIBUTES — 05-19-73 


TWO NEW QUEUE ATTRIBUTES HAVE BEEN IMPLEMENTED WHICH MAY BE USED TO 
TAILOR DISK TANKING PARAMETERS. THESE ATTRIBUTES ARE: 


1. QBLOCKSIZE SPECIFIES THE NUMBER OF WORDS PER BLOCK IN 
THE TANKING FILE. THE DEFAULT VALUE IS 300. 
THIS ATTRIBUTE WILL BE ROUNDED UP TO A 
MULTIPLE OF 30 IF NECESSARY. 


2. QROWSIZE SPECIFIES THE NUMBER OF BLOCKS TO BE 
ALLOCATED FOR EACH DISK ROW OF THE TANKING 
FILE. THE DEFAULT VALUE IS 10. 


PRAGMATICS: 
BOTH ATTRIBUTES ARE INTEGER VALUED. THEY MAY BE READ AT ANY TIME, 
BUT MAY NOT BE SET WHILE THE QUEUE IS TANKED. 


INCREASING THE VALUE OF QBLOCKSIZE REDUCES THE AMOUNT OF DISK 1/0 
TIME FOR A QUEVE WHILE INCREASING THE MEMORY REQUIREMENTS. TWO 
BUFFERS ARE ALLOCATED QBLOCKSIZE WORDS LONG FOR EACH QUEUE. 
THEREFORE, BY DEFAULT, 600 WORDS ARE REQUIRED FOR BUFFER SPACE. 


INCREASING QROWSIZE REDUCES THE OVERHEAD INVOLVED IN ALLOCATING 
TANKING DISK SPACE WHILE INCREASING THE DISK SPACE REQUIREMENTS. _ 
BY DEFAULT, 100 SEGMENTS ARE REQUIRED FOR EACH ROW OF THE TANKING 

FILE. . 


INITIALLY, TWO ROWS ARE ALLOCATED WHEN TANKING IS INVOKED. ROWS 
ARE ALLOCATED AND DEALLOCATED AS THE SIZE OF THE QUEUE INCREASES 
AND DECREASES. ALL DISK SPACE IS RETURNED WHEN THE QUEUE IS NO 
LONGER TANKED. THE TANK FILE MAY CONTAIN A VIRTUALLY UNLIMITED 
NUMBER OF ROWS. 
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USING THE COMBINE FUNCTION TO COMBINE TWO QUEUES WHOSE QROWSIZE 
AND/OR QBLOCKSIZE DIFFER CAN RESULT IN THESE VALUES BEING UNDEFINED 
IN THE <RESULT QUEVE> IF EITHER QUEUE IS TANKED AND <PRIORITY> = 
TRUE (COMBINE TO HEAD OF <RESULT QUEUE>.) 


DO313  MCP-DATACM - QUEUE DISK TANKING - 05-19-73 
DATACOM QUEUE DISK TANKING HAS BEEN REDESIGNED WITH THE FOLLOWING 
FEATURES. 


1. IMPROVED RELIABILITY. ALL KNOWN PROBLEMS HAVE BEEN SOLVED. 


2. INCREASED EFFICIENCY. TANKING IS NOW PERFORMED OUT. OF THE 
REQUESTING STACK, RATHER THAN INVOLVING THE OVERHEAD 
REQUIRED, AND THE DELAYS INHERENT, IN USING A SEPARATE 
INDEPENDENT. RUNNER. 


3. COMPLETE IMPLEMENTATION. THE FOLLOWING. FEATURES NOW 
EXIST: 


A. TANKING INVOKED BY INSERTING A MESSAGE TO THE HEAD 
OF A QUEUE NOW MAINTAINS THE ORDER OF ALL MESSAGES 
IN THAT QUEUE. 


B. COMBINING QUEUES WHICH ARE TANKED NOW RESULTS IN THE 
TANKED PORTIONS BEING COMBINED, ALSO. 


C. DECREASING THE MEMORY LIMIT OF A QUEUE (QMEMORYLIMIT 
ATTRIBUTE) WILL CAUSE EXCESS MESSAGES TO BE TANKED. 
INCREASING MEMORYLIMIT WILL HAVE NO IMMEDIATE EFFECT. 


fs. (PLEXIBIELT 2 THE USER MAY NOW DEFINE SEVERAL TANKING 
PARAMETERS VIA QUEUE ATTRIBUTES. -SEE DNOTE DO3l1e. 


3S. IMPROVED DISK ALLOCATION. POTENTIAL DEADLOCK SITUATIONS 
INVOLVING SEGMENTS REQUIRED FOR TANKING HAVE BEEN RESOLVED 
IN THE FOLLOWING MANNER: 


A. WHEN THE TANKING HANDLER BEGINS TO WORK ON THE LAST 
ROW OF A TANK FILE, IT WILL ATTEMPT TO ALLOCATE 
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ANOTHER ROW IN ANTICIPATION OF ITS NEEDS. IF 
INSUFFICIENT DISK SPACE EXISTS TO SATISFY THE 
REQUEST, A WARNING MESSAGE OF THE FORM. 

"<MIXNO> DISK TANK NEEDS <SEGMENTS> SEGS" 


IS DISPLAYED. THE JOB WILL BE ALLOWED TO PROCEED. 


B. IF ANOTHER DISK ROW IS IMMEDIATELY REQUIRED, THE 
USUAL 
"<MIXNO><SEGMENTS> SEGMENTS REQD" 


MESSAGE IS DISPLAYED. THE STACK REQUIRING THE SPACE 
IS SUSPENDED. HOWEVER, THE QUEUE INVOLVED IS 
UNLOCKED SUCH THAT OTHER STACKS MAY REMOVE MESSAGES 
FROM THE QUEVE (AND THEREFORE RETURN DISK SPACE). 


C. A STACK WHICH HAS BEEN SUSPENDED FOR LACK OF DISK 
TANK SPACE MAY BE: DS-ED. 


A NEW DCWRITE FUNCTION (TYPE=103) HAS BEEN IMPLEMENTED WHICH ALLOWS 
AN MCS TO DYNAMICALLY SET OR RESET ANY OR ALL LINE TOGS AND/OR LINE 
TALLIES FOR A GIVEN LINE. THE FORMAT OF THIS MESSAGE IS: 


MSG(01].047:81] = 103 
-[23:1)] = 1 
-[22:23) = DL : 
MSG[6].[23.1] = 1 => ENABLE SETTING OF LINE(TOG(1]) 
-Cee:l1) = 1 => ENABLE SETTING OF LINE(TOGIO)) 
-[21:1] = 1 => ENABLE SETTING OF LINEC(TALLYL11) 
eteOy- Lay = 1 => ENABLE SETTING OF LINECTALLYEO]) 
re (ar Ee SETTING OF LINE(TOG(1]) 
-C16:1) = SETTING OF LINECTOG[O1]) 
-015:8) = SETTING OF LINECTALLYCE11)) 


-07:8) SETTING OF LINECTALLY(0O1) 


THE MINIMUM MESSAGE SIZE FOR THIS DCWRITE IS EIGHT WORDS. 


BOOST? 


TO 


DO375 
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MCP-DATACM - SET LINE TOGS-TALLIES DCWRITE — 07-142 49° ae 


SET LINE(TOG[O3) = O AND LINECTALLYE1]) = 100: 


ALLOCATE (MSG ,8) ; 
MSG(OJ:= DL & (1)f23:11] & (103)047:31; 
MSG(6]:= 0 & (1)fee:1] & (1)0e1:1) 
& (0)£16:1) & (€100)015:8)1; 
RESULT:= DCWRITE (MSG) ; 


MCP-DATACM - STATION INTERROGATE —- 07-14-73 


TATION INTERROGATE DCWRITE (TYPE = FOUR) WILL NOW RETURN THE 


FIRST DCP LINE WORD IF LINE INFORMATION IS REQUESTED (MSG[01].(27:1] 


“=l). 


THE LINE WORD WILL BE THE SECOND WORD IN THE LINE INFORMATION 


SECTION. IF INX:=MSG[6].(7:8], THEN THE DCP LINE WORD IS AT MSG 
[MSGLINX].[31:8]+1]. THE BITS OF INTEREST IN THIS WORD ARE: 

[47:1] = LINE NOT READY 

[46:1] = LINE BUSY 

[45:1] = WRITE READY 

[44:1] = ACKNOWLEDGE READY 

[43:1] = LINE NOT CONNECTED 

[42:1] = LINE QUEVED 

[41:1] = LINE(TOGI11) 

(40:1) = LINEC(TOG(O]) 

[39:8] = STATION 

[31:8] = MAX STATIONS 

[23:8] = LINECTALLYT1)) 

[15:8] = LINECTALLY[O]) 


{O7: 


8] = COLINE NUMBER 
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D0376 © MCP-DATACM - RECONFIGURATION IMPROVEMENTS - 07-14-73 
SEVERAL IMPROVEMENTS TO DATACOM RECONFIGURATION HAVE BEEN MADE TO 
EXTEND ITS UTILITY IN DEALING WITH HARDWARE MALFUNCTIONS IN A 
DATACOM NETWORK. ONE SERIOUS PROBLEM WHICH HAS BEEN RESOLVED IS IN 
USING RECONFIGURATION AGAINST LINES WITH BAD ADAPTORS. SUCH LINES 
CAN PERMANENTLY ENTER A BUSY STATE. SINCE RECONFIGURATION REQUIRES 
LINES TO BE NOT READY BEFORE IT CAN COMPLETE A REQUEST, BAD LINES 
COULD PREVENT THE DCP FROM COMPLETING A "MAKE LINE NOT READY" 
REQUEST, THEREBY PREVENTING ‘THE TERMINATION OF A RECONFIGURATION 
REQUEST. A NEW DCP REQUEST, "BLAST LINE", ALLOWS THE DCP TO IGNORE 
THE BUSY STATE OF A LINE AND FORCE THE LINE NOT READY. 


SINCE UNCONDITIONAL USE OF THIS REQUEST COULD CAUSE ABNORMAL 
TERMINATION OF CURRENT REQUESTS ON GOOD LINES, RECONFIGURATION WILL 
RESORT TO ITS USE ONLY IF THE NORMAL "MAKE LINE. NOT READY" REQUEST 
IS NOT COMPLETED BY THE DCP WITHIN 10 SECONDS AFTER IT IS ISSUED. 
SINCE SOME REQUESTS MAY TAKE LONGER THAN 10 SECONDS, THE FOLLOWING 
GUIDELINES SHOULD BE CONSIDERED WHEN USING RECONFIGURATION: 


1. IF THE LINE(S)/STATION(S) INVOLVED IN THE REQUEST IS(ARE) 
BEING RECONFIGURED FOR HARDWARE PURPOSES (BAD LINE 
ADAPTER, BAD CLUSTER, FAIL-SOFT RECONFIGURTION, ETC.) 
THEN IF IT IS ASSUMED THAT NO MEANINGFUL REQUESTS ARE IN 
PROGRESS ON THE AFFECTED LINES, RECONFIGURATION CAN BE 
PERMITTED TO FORCE THE NECESSARY LINES NOT READY TO 
COMPLETE THE REQUEST. . 


2. IF RECON*:GURATION IS BEING INVOKED TO PERFORM A DYNAMIC 
MODIFICATION TO AN ACTIVE SUBSET OF THE DATACOM NETWORK, 
SUCH AS ADDING NEW STATIONS, LOAD LEVELING BETWEEN DCPS, 
CHANGING LINE ATTRIBUTE, ETC., AND USEFUL REQUESTS MAY BE 
IN PROGRESS ON THE LINE(S)/STATION(S) INVOLVED, THEN IT 
WOULD BE UNDESIRABLE TO FORCE LINES NOT READY. THIS CAN 
BE AVOIDED BY HAVING THE MCS PERFORM "MAKE LINE NOT READY" 
(TYPE=97) REQUESTS TO THE AFFECTED LINES AND WAITING FOR 
DCP ACKNOWLEDGEMENT OF THE NOT READY STATE OF THESE LINES 
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BEFORE MAKING THE RECONFIGURATION REQUEST. THIS PRACTICE 
WILL INSURE THAT THE LINES WILL NOT BE BUSY WHEN 

RECONFIGURATION EXECUTES THE REQUEST, THEREBY ELIMINATING 
THE NECESSITY FOR FORCING THE LINES NOT READY. 


RECONFIGURATION NOW ALLOWS REQUESTS WHICH INVOLVE OFF LINE OR 
UNINITIALIZED DCPS, WHICH PERMITS SYSTEMS TO RECONFIGURE THEIR 
NETWORK AFTER A DCP FAILURE. 


RECONF IGURATION WILL NOW RECOVER FROM A HALT/LOAD OCCURRING DURING 
EXECUTION OF A REQUEST. IF THE DATACOM FILES ARE NOT CHANGED 
BEFORE DATACOM IS - REINITIALIZED, RECONFIGURATION WILL BE INVOKED 
AUTOMATICALLY TO CONTINUE THE REQUEST IN PROGRESS AT THE TIME OF 
THE HALT/LOAD. ONLY THE REQUEST IN PROGRESS WILL BE RECOVERED. 


DOH69_  ~MCP-DATACM = DCP INITIALIZATION LOOP = 09-04-73 

IF DURING INITIALIZATION OF A DCP, THE DCP RESPONDS PROPERLY WITH A 
"HEYU" INTERRUPT, BUT, DUE TO A HARDWARE MALFUNCTION, FAILS TO 
RETURN THE "ADD CLUSTERS" REQUEST VIA ITS RESULT QUEUE, THE DCC 
STACK WILL NOW DISPLAY "DCP NOT READY" AND ABORT THE INITIALIZATION 
REQUEST. PREVIOUS TO THIS CHANGE, THE DCC WOULD LOOP INDEFINITELY 
UNDER THESE CIRCUMSTANCES. 


NEW FEATURES AND DOCUMENTATION CHANGES Ree. “ae 


DATA MANAGEMENT 


DOSS AUDITOEFIN = ADD YOB NUM TO MON UP REC — O7-19-73 | 


THIS PATCH DOCUMENTS A CHANGE TO THE AUDIT TRAIL -- THE JOB NUMBER 
OF THE MONITOR IS NOW INCLUDED IN THE AUDIT RECORD, AND FIXES A 
PROBLEM IN MONITOR. 


DO356 AUDITDEFIN —- DOCUMENT AUDIT REC TYPE ZERO - 07-29-73 © 


THIS PATCH DOCUMENTS THE FORMAT OF AUDIT RECORD TYPE ZERO. THIS 
TYPE OF RECORD IS USED AS A FILLER WHEN AUDITING TO TAPE, IN ORDER 
TO MAKE ALL TAPE BLOCKS THE SAME SIZE. MAKING ALL TAPE BLOCKS THE 
SAME SIZE INCREASES THE LIKELIHOOD THAT TAPE PARITY RETRY WILL BE 
SUCCESSFUL . 


DOSS7 = COPYAUDIT == DM INITIAL COPY AUDITTAPE a he 
SYSTEM/COPYAUDITAPE IS A UTILITY PROGRAM THAT WILL COPY A DM6700 
AUDIT TAPE UP TO THE FIRST BAD SPOT. THIS WILL BE USEFUL IN CASE 
AN 1/0 ERROR IS ENCOUNTERED DURING A CLOSE OF THE AUDIT TAPE. IN 
THIS CASE, DMRECOVER WILL NOT RUN PROPERLY BECAUSE IT WILL GET AN 
1/0 ERROR ON THE TAPE. TO GET AROUND THIS PROBLEM SYSTEM/ 
COPYAUDITTAPE SHOULD BE RUN TO GET A GOOD COPY OF THE TAPE AND RUN 
DMRECOVER AGAIN. 


IT SHOULD BE RUN WITH FILE TAPE LABEL EQUATED TO THE BAD AUDIT TAPE. 
THE TITLE, CYCLE AND THE KIND ATTRIBUTES SHOULD BE SET. THE 
PROGRAM WILL PRODUCE A NEW AUDIT TAPE OF THE SAME KIND AS THE OLD 
TAPE: 


THE PROGRAM DIVIDES BY ZERO ON ANY ABNORMALITY, INCLUDING I/0 


, PAGE 
DO357 COPYAUDIT - DM INITIAL COPYAUDITTAPE —- O7-19- 73 i 


ERRORS, AND AUDIT RECORDS WHICH HAVE BAD CONTROL WORDS. THIS IS 
DONE TO GET A PROGRAM DUMP SO THE RECORD IN ERROR MAY BE OBSERVED. 


NOTE: THIS PROGRAM DOES NOT SOLVE THE PROBLEM OF HAVING A BAD SPOT 
IN THE MIDDLE OR BEGINNING OF AN AUDIT TAPE. AN ATTEMPT IS MADE BY 
DM6700 TO AVOID THIS BY CLOSING AN AUDIT TAPE IF A WRITE ERROR 
OCCURS, SO ANY BAD SPOTS SHOULD BE AT THE END. IT IS ALWAYS BEST 
TO USE CLEAN TAPES OF HIGH QUALITY FOR AUDIT TAPES. 


OB: -RMERENTIT. 2 DOCUMENTA LION AN? ESTHETICS a 
COMMENTS CONCERNING COARSE TABLE PROCEDURE PARAMETERS -ARE PROVIDED. 
A ROW OF BLANKS BETWEEN LAST SDL STRUCTURE INFORMATION AND LAST ROW 
OF ASTERISKS IS ADDED. 


DORO7. “DURECOVER: So {eel DUNpEAVer I Eos ABITE Eh See 
IN ADDITION TO LOGGING 1/0 ERRORS IN A DUPLICATED DISK FILE, 
DMRECOVER WILL ALSO NOW GIVE A PROGRAM DUMP. — 


DOS29 = DMROWRECOV - ADDITIONAL ERROR MESSAGE = OS-es773 

IF THE DM MONITOR (SYSTEM/DM6700) DOES NOT HAVE THE DOLLAR OPTION 
"AUDIT" COMPILED IN THEN, WHEN DMROWRECOVERY IS TOLD THIS BY THE 
MONITOR, DMROWRECOVERY WILL RETURN THE ERROR MESSAGE | 


"AUDIT CAPABLE MONITOR REQD" 


00297 DMG700 = DM = NEW STATUS CORRECTION = O4—11-73 

DNOTE DOeSO IN’ THE II.4 SYSTEM MISCELLANEA INCORRECTLY DOCUMENTS 
THE NEW DATA MANAGEMENT STATUS VALUE AS EIGHT (WHICH IS REALLY 
"POPULATION EXCEEDED"), RATHER THAN 22, WHICH IS ITS CORRECT VALUE. 


DO297 


DM6700 - DM —- NEW STATUS CORRECTION -—- O4-11- oT ae ot 


PRIOR TO II.4, A VALUE OF SIX WAS RETURNED FOR THE CASE WHERE THERE 
WAS NO MASTER FOR THE SLAVE BEING OPERATED UPON. WITH II.4, 22 IS 
RETURNED FOR THIS CASE. 


DO353 


DM6700 - AUDIT AND RECONSTRUCTION IMPRV —- 08-12-73 


1.1 AUDIT BY RECORD . 
1.2. AUDIT BUFFERSIZE 
1.3. TAPE AUDIT 

1.4. DISPLAY MESSAGES 
1.5. AUDIT TAPE COPY 


2. RECONSTRUCTION 


REWRITE 

DOUBLE BUFFERING 

1/0 ERRORS 

DMROWRECOVERY SYNCHRONOUS 
NOTES ON RECONSTRUCT.ION 


MM Mw mM Po 
otf W Ph - 


2.5.1 SDL RECORD. ZERO 
evo.e “SDLy PLE 


AUDIT AND RECONSTRUCTION IMPROVEMENTS 


THE 2.4 RELEASE OF DATA MANAGEMENT INCORPORATED AUDITING BY 
BLOCK. NOW, AUDIT IS BY RECORD. THIS RESULTS IN A SAVINGS 
OF TIME AND SPACE. LESS DATA HAS TO BE MOVED TO THE AUDIT 


DM6700 - AUDIT AND RECONSTRUCTION IMPRV - ga=ie-73"" ee 


BUFFERS AND WRITTEN TO THE AUDIT TRAIL. THE NEW RELEASE 
WILL HANDLE AUDIT FILES MADE UNDER THE @.4 RELEASE AS WELL 
AS THE NEW AUDIT BY RECORD FORMAT. 


AUDIT BUFFERSIZE 
THE SIZE OF THE BUFFERS FOR THE AUDIT MAY NOW BE SPECIFIED 
IN SDL/INITIALIZE IN THE AUDIT STATEMENT. FOR EXAMPLE, 


AUDIT 
BUFFERSIZE = e000 


DEFAULT SIZE 1S 900 WORDS, MAX IS 4080. WHEN AUDITING TO 
DISK, THREE BUFFERS ARE USED. WHEN AUDITING TO TAPE, TWO 
ARE USED (BUT IF AN I/0 ERROR OCCURS, THERE WILL BE A 
TEMPORARY THIRD BUFFER). 


THE SIZE OF THE AUDIT BUFFERS IS CRITICAL. THEY SHOULD BE 
MADE LARGE ENOUGH TO HOLD ALL THE INFORMATION FOR AN 
AVERAGE SIZED TRANSACTION. THEN ONLY ONE WRITE WILL BE 
PERFORMED FOR THE AVERAGE TRANSACTION. IF THE AUDIT BUFFER> 
SIZE IS TOO SMALL, MORE THAN ONE WRITE WILL BE NEEDED FOR 
THE TRANSACTION, BECAUSE THE BUFFER WILL OVERFLOW AT LEAST 
ONCE DURING TRANSACTION. 


A DOUBLE BUFFERING SCHEME IS NOW USED BY THE MONITOR. 
REQUEST HANDLERS MAY NOW MOVE INFORMATION INTO ONE BUFFER 
WHILE AN I/O IS IN PROGRESS ON THE OTHER. IN THE e.4 
RELEASE, THE MONITOR WAITED FOR COMPLETION OF ALL WRITES TO 
THE AUDIT TRAIL WITH NO OVERLAP OF I/0 AND PROCESSING. 


HOP UDI I. 

PROBLEMS WITH AUDIT AND RECOVERY TO TAPE HAVE BEEN NOTED. 
THEY WERE DUE TO TAPE PARITY RETRY BY THE MCP. THE WORST 
CASE FOR THE TAPE PARITY RETRY ALGORITHM WAS A LONG BLOCK 
FOLLOWED BY A SHORT ONE FOLLOWED BY A LONG ONE, ETC. (THIS 
WAS THE USUAL SITUATION IN THE AUDIT TRAIL.) IN THIS CASE, 
TAPE PARITY. RETRY OFTEN INCORRECTLY POSITIONED THE TAPE, 


DM6700 - AUDIT AND RECONSTRUCTION IMPRV - os=iba7s a 


RESULTING IN LOST INFORMATION. 


TO ALLEVIATE THIS PROBLEM, A DUMMY AUDIT RECORD OF ZEROES 
IS NOW USED TO PAD OUT THE BLOCK. AUDIT TAPE BLOCKS ARE 
ALL THE SAME LENGTH, WITH THE FOLLOWING RARE EXCEPTIONS: 


IF THE AUDIT BUFFER SIZE IS LESS THAN THE SIZE OF ANY INDEX 
TABLE OR DATA RECORD, IT WILL BE DYNAMICALLY RESIZED 
UPWARDS WHEN IT IS NECESSARY TO AUDIT AN AFTER IMAGE OF 
SUCH A RECORD. THIS WILL RESULT IN A JUMP OF THE TAPE 
BLOCK SIZE. THIS CASE SHOULD BE VERY RARE, AS THE AUDIT 
BUFFER SIZE MUST BE MUCH LARGER THAN THIS FOR EFFICIENT 
OPERATION OF THE AUDIT. 


THE SERIAL NUMBER (RECORD NUMBER) OF EACH TAPE BLOCK IS NOW 
INCLUDED IN THE AUDIT PHYSICAL CONTROL WORDS. THE SERIAL 
NUMBER IS CHECKED BY DMRECOVER, ETC., SO THAT MISSING TAPE - 
BLOCKS ARE EXPLICITLY DETECTED. MISSING TAPE BLOCKS WILL 
RESULT IN UNSUCCESSFUL RECOVERY. 


THE SERAIL NUMBER IS ALSO USED BY THE MONITOR WHEN IT TRIES 
TO REPOSITION AN AUDIT TAPE SO THAT IT CAN CLOSE IT AFTER 
AN IRRECOVERABLE I/O ERROR HAS OCCURRED. 


DISPLAY MESSAGES 
THE MONITOR NOW DISPLAYS THE DATA BASE NAME AND THE AUDIT 
PACK NAME WHEN AUDITING (EVEN IF THE AUDIT DOES NOT GO TO 
PACK, BUT TO TAPE OR DISK). IN ADDITION, WHENEVER A NEW 
AUDIT FILE IS CREATED, THE REQUEST HANDLER DISPLAYS ITS 
SERIAL NUMBER AND THE RECORD NUMBER OF THE CORRESPONDING 
AUDIT ARCHIVE ENTRY. THUS, THE SYSTEM LOG CAN BE USED TO 
REBUILD THE AUDIT ARCHIVE BY HAND, IF NECESSARY. 


NOTE: TO PREVENT THE AUDIT ARCHIVE FROM EVENTUALLY 

OVERFLOWING, IT MAY BE REMOVED AFTER A COMPLETE DUMP OF THE 
DATA BASE HAS BEEN DONE. THIS IS BECAUSE THE MONITOR 
CREATES THE AUDIT ARCHIVE IF IT IS NOT RESIDENT WHEN IT 
FIRST BEGINS OPERATION, AND BECAUSE THE AUDIT FILES CREATED 


DO0353 
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BEFORE THE DUMP WILL NOT BE NEEDED (ASSUMING THE DUMP WAS 
SUCCESSFUL). 


AUDIT TAPE COPY 

THE MONITOR ATTEMPTS TO CLOSE AN AUDIT TAPE IF IT 
ENCOUNTERS AN ERROR IN WRITING IT. HOWEVER, IT IS POSSIBLE 
FOR CLOSE TO FAIL. IF THE TAPE IS NOT CLOSED PROPERLY OR 
IF THERE IS AN I/O ERROR ON IT, THEN RECOVERY WILL NOT BE 
SUCCESSFUL. TO ALLEVIATE THIS PROBLEM, SYSTEM/ 
COPYAUDITTPAPE HAS BEEN IMPLEMENTED. WHEN IT IS RUN, FILE 
TAPE SHOULD BE LABEL EQUATED TO THE AUDIT TAPE TO BE COPIED 
AND THE TITLE AND KIND ATTRIBUTES SHOULD BE SET. 
COPYAUDITTAPE WILL CREATE A NEW AUDIT TAPE OF THE SAME KIND 
AS THE OLD ONE AND WILL DIVIDE BY ZERO ON ANY I/0 ERRORS OR 
IF THE AUDIT TRAIL FAILS CERTAIN VALIDITY CHECKS. THE NEW 
AUDIT TAPE CAN BE USED BY DMRECOVER. 


NOTE THAT COPYAUDITTAPE IS A LAST RESORT AND WILL NOT BE 
ABLE TO PRODUCE A COMPLETE AUDIT TAPE FROM ONE WHICH HAS AN 
1/0 ERROR BEFORE THE LAST BLOCK. 


RECONSTRUCT ION 


RECONSTRUCTION HAS BEEN REWRITTEN AND THOROUGHLY TESTED. 
THE NEW VERSION IS MORE EFFICIENT AND MANY PROBLEMS HAVE 
BEEN FIXED. . 


DOUBLE BUFFERING 

DOUBLE BUFFERING HAS BEEN ADDED TO RECONSTRUCTION IN. ORDER 
TO OVERLAP 1/0 WITH PROCESSING. A FEWER TOTAL NUMBER OF I/ 
OS IS DONE THAN UNDER THE 2.4 RELEASE. 
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INSTEAD OF DIVIDING BY ZERO ON I/O ERRORS, RECONSTRUCTION 
RETURNS A STATUS OF 24. ALSO, IF AN INSUFFICIENT NUMBER OF 
BUFFERS IS AVAILABLE TO RECONSTRUCTION, IT RETURNS AN ERROR 
STATUS OF eH. 


RECONSTRUCTION HAS THE SAME NUMBER OF BUFFERS AS THE 
MONITOR WHEN AUDIT IS COMPILED IN, NAMELY TWO TIMES 
MAXBUFFERS. THUS, IF COBOL PROGRAMS ARE UPDATING THE DATA 
BASE DURING RECONSTRUCTION, THERE ARE 4*MAXBUFFERS BUFFERS 
PRESENT IN CORE. IF TWO STRUCURES ARE BEING RECONSTRUCTED 
AT THE SAME TIME WHILE COBOL PROGRAMS ARE RUNNING AGAINST 
THE DATA BASE (THREE REQUEST HANDLERS), THERE ARE 6* 
MAXBUFFERS BUFFERS. 


IF NO COBOL PROGRAMS ARE AROUND AND THE MONITOR IS 
INITIATED BY SYSTEM/DMROWRECOVERY FOR RECONSTRUCTION, ONLY 
2*MAXBUFFERS WILL BE PRESENT. 


DMROWRECOVERY SYNCHRONOUS 

DMROWRECOVERY NOW WAITS FOR A REPLY FROM THE MONITOR AND 
DISPLAYS THE STATUS OF ITS REQUEST. FORMERLY , 
DMROWRECOVERY MERELY SENT THE REQUESTS TO THE MONITOR AND 
WENT TO END OF JOB: 


NOTES ON RECONSTRUCT ION 


SDL RECORD ZERO 


THE MONITOR READS SDL RECORD ZERO BEFORE PROCESSING ANY 
REQUESTS. THUS, THIS RECORD MUST BE RE-ESTABLISHED BY THE 
USER, IF THE ONLY COPY OR BOTH COPIES ARE DESTROYED. AMONG 
THE THINGS IN RECORD ZERO ARE: 


DATA BASE IN USE BIT 
AUDIT INFORMATION 


6 
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CURRENT AUDIT SERIAL NUMBER 

AUDIT PACK NAME 

AUDIT FILE SIZE, ETC. 
MONITOR LIMITS 

MAX NUMBER OF REQUEST HANDLERS 

MAX NUMBER OF BUFFERS, ETC. 
DUPLICATED FILE BIT FOR SDL FILE 
ERROR FLAG AND COPY LOCKS FOR SDL FILE 


e29.e, SOE FILE 
IF THE SDL FILE IS DAMAGED, IT MUST BE RECONSTRUCTED OR 
RESTORED - BEFORE THE CORRESPONDING DATA BASE STRUCTURES CAN 
BE USED. THUS, IT IS A GOOD IDEA TO HAVE A SMALL AREAS]! ZE 
(E.G., ONE) FOR THE SDL FILE. 


THERE ARE UNUSED WORDS IN MOST OF THE SDL RECORDS. THE 
MONITOR WRITES RANDOM BIT PATTERNS IN THESE WORDS UNLESS 
AUDIT AND DIAGNOSTICS “ARE COMPILED IN. THEN THESE WORDS 
ARE ZEROES. RECONSTRUCTION WILL RESTORE THESE UNUSED WORDS 
FROM THE BACKUP. THIS SHOULD BE BORNE IN MIND WHEN TESTING 
RECONSTRUCTION: A BIT-BY-BIT COMPARE MAY FAIL ON A PROPERLY 
RECONSTRUCTED SDL RECORD, BECAUSE THE UNUSED WORDS WILL NOT 
MATCH UNLESS THE MONITOR HAD DIAGNOSTICS AND. AUDIT COMPILED 
IN. 


A REQUEST HANDLER ONLY RECONSTRUCTS OR RESTORES ONE DATA 
BASE FILE AT .A TIME, AS SPECIFIED BY THE REQUEST FROM 
DMROWRECOVERY . 


DO405 = =DMG700 - IMPLEMENT ROW RECOV IOERR STAT - 07-29-73 

A STATUS OF 24 FROM SYSTEM/DMROWRECOVERY INDICATES THAT AN. 1/0 
ERROR OCCURRED DURING RECONSTRUCTION OR RESTORATION IN THE MONITOR, 
OR THAT INSUFFICIENT BUFFERS WERE AVAILABLE DURING RECONSTRUCTION 
(MAXBUFFERS WILL HAVE TO BE INCREASED). 


DO4OS == OMG700 = AUDIT DISPLAY PATCH - 07-29-73 page 2 


DEAS DNS 700" SS aURTT Dleroar eater. 2 Ureee-23 

WHEN AUDITING, THE MONITOR DISPLAYS THE DATA BASE NAME, THE AUDIT 
TAPE NAME, AND THE SERIAL NUMBER AND AUDIT ARCHIVE RECORD NUMBER OF 
EACH NEW AUDIT FILE AS IT IS CREATED. IF THE AUDIT ARCHIVE IS 
LOST, IT MAY BE POSSIBLE TO REBUILD IT BY HAND USING THE 
INFORMATION NOW INCLUDED IN THE LOG. WHEN RUNNING RECONSTRUCTION, 
THE AUDIT FILE DESIRED IS DISPLAYED TO AID IN RESOLVING DUPLICATE 
FILE CONDITIONS. 


Bone SONG TOO: Wo DUMMY EIEESR OR TAPE AUDI” > Oi zeg=72 

WHEN AUDITING TO TAPE, A DUMMY AUDIT RECORD IS ADDED SO THAT ALL 
BLOCKS WILL BE OF EQUAL SIZE. THIS IS NECESSARY BECAUSE THE MCP 
TAPE PARITY RETRY ALGORITHM ASSUMES THIS TO BE TRUE. CONSEQUENTLY, 
RECORDS SOMETIMES GET LOST WHEN THE TAPE BLOCK SIZE DIFFERENCE IS 
SIGNIFICANT. 


DOU19 GETDMRSF —- ALLOW LAST TAPE BLOCK PARTIAL - 07-19-73 


THIS PATCH TAKES INTO ACCOUNT THE FACT THAT THE LAST BLOCK ON AN 
AUDIT TAPE MAY BE A PARTIAL BLOCK. 


DO315 SDLS - AUDIT BUFFERSIZE - 05-09-73 


THIS CHANGE GIVES THE USER THE ABILITY TO SPECIFY IN THE AUDIT 
STATEMENT IN SDL/INITIALIZE: 


BUFFERSIZE = <INTEGER> © 
THIS SPECIFIES THE SIZE OF THE AUDIT BUFFERS. 


THE AUDIT BUFFERSIZE CONTROLS AN IMPORTANT. TRADEOFF IN THE 
OPERATION OF THE AUDIT: THE LARGER THE AUDIT BUFFER SIZE THE FEWER 


D0315  SDLS - AUDIT BUFFERSIZE - 05-09-73 Rage: “ee 


THE WRITES THAT WILL BE INITIATED TO THE AUDIT TRAIL BECAUSE THE 
BUFFER OVERFLOWED, BUT THE GREATER THE CORE THAT WILL BE TIED UP. 
(THERE ARE SEVERAL AUDIT BUFFERS.) THE DEFAULT IS 900 WORDS. 


DO316 = =SDLS T= SOL AND TABLE AREASIZE = 05-09-73 

THIS CHANGE ALLOWS THE USER THE ABILITY TO SPECIFY THE AREASIZE OF 
OTHER THAN FILES IN SYSTEM/SDL/INITIALIZE: AREASIZE FOR INDEX 
SEQUENTIAL (FINE TABLES ONLY), INDEX RANDOM, TAG, BIT. SDL CAN NOW 
BE SPECIFIED VIA THE SYNTAX FOR SET OR STRUCTURE, I.E., 


SET SDL AREASIZE = 1; 
SET 5 AREASIZE = 100; 


00324 SDLS - CHNGE DEFAULT AUDIT CYCLE TIME - 05-31-73 

THIS CHANGE ALTERS THE DEFAULT AUDIT CONTROL CYCLE TIME FROM 10 TO 
4O CYCLETIMES, THAT IS FROM EVERY 30 SECONDS TO EVERY TWO MINUTES 
(IF CYCLETIME IS DEFAULT). THIS MEANS THAT THERE WILL BE FEWER 
CONTROL RECORDS IN THE AUDIT TRAIL; ERGO, RECOVERY WILL TAKE A 
LITTLE LONGER. 


NEW FEATURES AND DOCUMENTATION CHANGES PAGE 89 


DCALGOL 


THIS CHANGE IMPLEMENTS TWO NEW QUEUE ATTRIBUTES "QBLOCKSIZE" AND 
"QROWSIZE". BOTH ATTRIBUTES ARE INTEGER-VALUED AND CAN BE READ OR 
WRITTEN. 


THIS CHANGE CAUSES A WARNING MESSAGE TO BE EMITTED IF THE VARIABLE 
DECLARED TO RECEIVE THE RESULT OF A HOLD STATEMENT IS NOT DECLARED 
DOUBLE . 


DOY71 DCALGOL - DISKHEADER ARRAYS - 08-26-73 


THIS CHANGE FORCES ALL <DISKHEADER ARRAY>S TO BE LONG. THE 
DECLARATION 


DISKHEADER ARRAY DAI[0:191; 
IS NOW EQUIVALENT TO THE DECLARATION 
LONG DISKHEADER ARRAY DA(0:191; 


NEW FEATURES AND DOCUMENTATION CHANGES aCe 


DCPPROGEN 


—-— ere ee ee 


90 


THIS PATCH ADDS A’ FEATURE IN WHICH THE LINE TOGGLES ARE SET TO 
FALSE AND THE LINE TALLYS ARE SET TO ZERO WHENEVER A SWITCHED LINE 


IS CONNECTED. NOTE: THIS MAY AFFECT EXISTING REQUEST SETS. 


PA 
NEW FEATURES AND DOCUMENTATION CHANGES eee ae 


DCSTATUS 


DO397 DCSTATUS —- RUNNING DCSTATUS THROUGH CANDE -— 07-08-73 


THIS PATCH IMPROVES THE PERFORMANCE OF DCSTATUS WHEN EXECUTED FROM 
A REMOTE TERMINAL. A PERIOD IS NOW RECOGNIZED AS A_ VALID 
SUBSTITUTE FOR THE SEMICOLON IN THE DCSTATUS INPUT COMMAND AVOIDING 
THE ERRONEOUS RECOGNITION OF THE SEMICOLON AS A CANDE STATEMENT 
DELIMITER. FOR EXAMPLE: 


DC DCP 1. LINE 0:12 


A COLON _1S ALSO NOW SYNONYMOUS WITH A COMMA. DCSTATUS WILL ALSO 
NOW GRACEFULLY TERMINATE WHEN IT ENCOUNTERS A BREAK ON OUTPUT. 


PAGE 9e 
NEW FEATURES AND DOCUMENTATION CHANGES : 


DO300 ESPOL - VERSION DOLLAR OPTION -— 05-07-73 


THIS PATCH IMPLEMENTS THE FOLLOWING ADDITIONAL SYNTAX FOR THE 
VERSION DOLLAR OPTION: 


<OPTION CONTROL CARD>: := 
$SET VERSION<VERSION INCREMENT>.<CYCLE INCREMENT><PATCH NUMBER>. 


WHERE 
<VERSION INCREMENT>::= + <INTEGER> 
<CYCLE INCREMENT>::= + <INTEGER> 
<PATCH NUMBER>::= <EMPTY> / .<3 DIGIT INTEGER> 


IF VERSION INCREMENT AND CYCLE INCREMENT APPEAR ON THE VERSION CARD 
THEN THOSE INCREMENTS WILL BE ADDED TO THE VERSION ON THE SYMBOLIC. 
IF NO VERSION CARD APPEARS IN THE SYMBOLIC THE INCREMENTS VALUES 
WILL BE USED TO APPEND TO THE CARD IMAGES. 


IF THE PATCH NUMBER APPEARS ON THE VERSION CARD IT WILL UPDATE THE 
SYMBOLIC VERSION CARD. ALSO, THE PROGRAMMER CAN GAIN ACCESS TO THE 
PATCH NUMBER BY ACCESSING COMPILETIME (22). 


—_—— se —_--—--——— ee mt mr re ee oe ——_—— ee 


AN INDICATION OF CARD IMAGES THAT ARE BEING REPLACED, DELETED, OR 
VOIDED IS NOW AVAILABLE IF "LISTDELETED" IS SET. 


DO341  ESPOL —- NAME DECLARATIONS — 06-24-73 Ree: t23 


DOS41 ESPOL - NAME DECLARATIONS - 06-24-73 


THE WORD "NAME" IN ESPOL HAS BEEN MADE RESERVED IN ORDER TO SPEED 
UP COMPILATION. 


DO34e ESPOL - VALUE ARRAYS - 06-24-73 


THIS CHANGE INCREASES THE SIZE ALLOWABLE FOR INITIALIZED VALUE 
ARRAYS FROM 511 WORDS TO 8192 WORDS (OR CHARACTERS FOR STRING 
ARRAYS) . 


DO363 ESPOL’. FILES “AT LEX LEVEL. ZERO. = 067-e4- 7s 


ESPOL NOW PERMITS ADDRESS-EQUATED FILES (AND NO FILES IN ANY OTHER 
FORM) AT LEX LEVEL ZERO. SYNTAX EXAMPLE: 


FILE F=W; 
THE FORMS 


FILE FCATTRIBUTES); OR 
FILE F; 


WILL STILL BE GIVEN A SYNTAX ERROR AT LEX LEVEL ZERO. 


DOWO7 ESPOL - eee 5S SIZE EIMEL ~=-07-18=73 


THE DOLLAR PARAMETER "SIZECHECK" ALLOWS THE COMPILER TO LIMIT THE 
SIZE OF SEGMENT 5 FOR MCP COMPILATIONS. THE SYNTAX IS: 


SIZECHECK <INTEGER>. 


THE COMPILER WILL SYNTAX ANY MCP HAVING A SEGMENT 5S LARGER THAN THE 
<INTEGER>. 


pou7@ ESPOL - ESPOL BINDINFO - 08-19-73 AGE, ~ ast 


BEI7e sESEOE ee SROL BINOINEO “= > 08219-73 

INFORMATION FOR ESPOL BINDING HAS BEEN REVISED TO BE CONSISTENT 
WITH OVERALL IMPLEMENTATION. IN ORDER TO INCLUDE ALL BINDINFO WHEN 
COMPILING ESPOL THE DOLLAR CARD 


SSET MAKEHOST * 


IS REQUIRED. WHEN SET, THE MCP PROCEDURES COMPILED AT LEVELS 
HIGHER THAN GLOBAL CAN BE BOUND. WHEN THE OPTION IS RESET A 
SOMEWHAT MORE LIMITED FORM OF BINDINFO IS PRODUCED THAT WILL PERMIT 
BINDING GLOBAL AND EXTERNAL PROCEDURES ONLY. THIS LATTER FORM HAS 
A SMALLER CODE FILE WHICH MAY FACILITATE CHANGING MCPS. 


DOS30  ESPOL —- IMPROVED THREE-CARD LOADER - 07-23-73 

THIS CHANGE IMPLEMENTS AN IMPROVED THREE-CARD LOADER, ADDING THE 
CAPABILITIES OF RECOVERING FROM CARD-READER ERRORS, AND OF LOADING 
LARGER DECKS. 


See essen ae eee nO eee RE re eenleais 

WHEN COMPILING MULTIPLE PROCEDURES, SUCH AS THE ESPOL INTRINSICS, 
IT IS NOW MORE EFFICIENT TO SET THE DOLLAR OPTION "LIBRARY". THIS 
WILL CAUSE ALL OBJECT PROGRAM CODE TO BE PUT IN ONE FILE AND MARKED 
AS A MULTI-PROCEDURE CODE FILE. BINDER CONTROL CARDS FOR BINDING 
THESE PROCEDURES, EITHER TO AN MCP OR TO AN INTRINSIC FILE, WILL 
HAVE TO BE CHANGED HOWEVER. IF, FOR EXAMPLE, SOME PROCEDURES WERE 
COMPILED AS "A/B", THEN THE BIND CARD WOULD HAVE TO BE CHANGED 


FROM: BIND = FROM A/=; 
TO: BIND FROM A/B; 


WHEN COMPILING FROM CANDE, THE LIBRARY OPTION IS INITIALIZED TO 
TRUE. 


po4el 


NEW FEATURES AND DOCUMENTATION CHANGES BADE 


ESPOLINTRINSICS 


ESPOLINTRN —- NEW FREEFIELD OUTPUT FEATURES — 09-04-73 


95 


THE FORTRAN USER NOW HAS A WIDER VARIETY OF FREEFITELD OUTPUT 
OPTIONS AVAILABLE TO HIM. INSTEAD OF JUST THE "/" FORM, E.G., 


USED 


LZ 


AS 


IN THE STATEMENT PRINT /,A,B,C THE FOLLOWING 16 FORMS ARE 
AVAILABLE : 


THE / FORM, AS USED IN PRINT /,LIST ETC. THIS FORM 
INSTRUCTS THE I/0 SUBSYSTEM TO OUTPUT THE LIST ITEMS IN 
WHATEVER FORMAT BEST DISPLAYS THEM, WITH THE FORMAT 
VARYING FROM LIST ELEMENT TO LIST ELEMENT (HEREAFTER 
ABBREVIATED L.E.). THE L.E.S MAY BE ANY VARIABLE, 

EXPRESSION, OR STRING (SEE THE DOCUMENTATION IN THE 


FORTRAN SYSTEM NOTES FOR’ AN INTRODUCTION TO STRINGS IN. 


FREEFIELD OUTPUT LISTS). 


INTEGER VARIABLES. AND EXPRESSIONS ARE OUTPUT IN AN 
INTEGER-TYPE FORMAT (UNLESS FOR SOME REASON THEY EXCEED IN 
MAGNITUDE THE LARGEST INTEGER -- 549755813887 -- E.G., .AN 
INTEGER VARIABLE IS EQUIVALENCED TO A REAL VARIABLE OF 
MAGNITUDE €+50; IN THIS CASE, IT WOULD BE TREATED AS TYPE 
REAL). 


REAL VARIABLES AND EXPRESSIONS ARE OUTPUT IN AN F-TYPE OR 
E-TYPE FORMAT, WHICHEVER ALLOWS THE MAXIMUM AMOUNT OF 
NUMERICAL SIGNIFICANCE IN THE LEAST WIDTH. COMPLEX 
VARIABLES AND EXPRESSIONS ARE TREATED AS TWO SUCCESSIVE 
REALS, FIRST THE REAL PART AND THEN THE IMAGINARY PART. 


DOUBLE PRECISION VARIABLES AND EXPRESSIONS ARE OUTPUT IN 
AN F-TYPE OR D-TYPE FORMAT, WHICHEVER ALLOWS THE MAXIMUM 
AMOUNT OF NUMERICAL SIGNIFICANCE IN THE LEAST WIDTH. 


LOGICAL VARIABLES AND EXPRESSIONS ARE OUTPUT AS T FOR TRUE 


VALUES AND AS F FOR FALSE VALUES. 
STRINGS ARE OUTPUT EXACTLY AS THEY APPEAR IN THE LIST. 


EACH EDITED LIST ITEM IS FOLLOWED BY A COMMA (,) AND A 
BLANK CHARACTER. THE EDITED LIST ITEM IS NEVER SPLIT 
ACROSS A RECORD BOUNDARY. IF THE RECORD LENGTH IS TOO 


SHORT TO ACCOMODATE THE EDITED LIST ITEM, THE L.E. IS RE- 
EDITED IN A FORMAT TO FIT WITHIN THE RESTRICTIVE RECORD 
LENGTH. IF THIS RECORD LENGTH IS TOO SHORT TO ACCOMODATE 
ANY REPRESENTATION OF THE L.E., A STRING CF POUND SIGNS 
(#...#) IS OUTPUT IN PLACE OF THE EDITED LIST ITEM. 


EXAMPLES 


PRINT /,123.456000,-.00123.1234,1.234D-1234,3.12E£50 
PRODUCING: 
123.456, -0.00123, 1234, 1.234D-1234, 3.12E+50, 
AND, » 


PRINT /,"THIS IS A STRING",.TRUE.,.NOT..TRUE., 
9.87654321987D87 


PRODUC ING: 
THIS IS A STRING, T, F, 9.87654321987D+87, 


THE (R)/ FORM, AS USED IN PRINT (6)/,LIST ETC. THIS 
FORM INSTRUCTS THE I/O SUBSYSTEM TO OUTPUT THE LIST ITEMS 
IN A MANNER SIMILAR TO THE ONE DESCRIBED ABOVE, BUT WITH 
THE FEATURE OF OUTPUTTING ONLY RL.E.S PER RECORD; THE 
EDITED L.E. IS MADE TO FIT WITHIN C CHARACTERS, WHERE C 
IS THE MAXIMUM INTEGER NOT EXCEEDING 
(RECORDLENGTHINCHARACTERS/ABS(R))-2, AND GREATER THAN 0. 
THIS CONSTRAINT PRODUCES COLUMNAR OUTPUT, R COLUMNS TO A 
RECORD, EACH COLUMN C+2@ CHARACTERS WIDE (THE @ REPRESENTS 
THE TWO DELIMITING CHARACTERS: THE COMMA AND THE BLANK). 
IF AN EDITED L.E. REQUIRES LESS THAN C CHARACTERS, 
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“LEADING BLANKS ARE INSERTED TO FILL OUT TO C CHARACTERS. 
IF THE L.E. CANNOT BE EDITED TO FIT WITHIN C CHARACTERS, 
A STRING OF C POUND SIGNS (#...#) IS OUTPUT IN PLACE OF 
THE EDITED L.E. 


EXAMPLES: 


PRINT (2)/,122334.567,-.2,45,-1.543267E-47 


PRODUCING: 
122334 .567, -0.2, 
45, —1.543267E-47, 


IN THE ABOVE EXAMPLE, EACH FIELD WIDTH IS 18 CHARACTERS. 
THIS IS BECAUSE THE MAXIMUM FIELD WIDTH REQUIRED TO EDIT 
ANY INTEGER OR REAL IS 18 CHARACTERS. IN GENERAL, THE 
COMPILER ASSIGNS A MAXIMUM FIELD WIDTH VALUE OF 1 TO 
LOGICALS, 18 TO INTEGERS AND REALS (REMEMBER THAT COMPLEX 
IS 2 REALS), 33 TO DOUBLES, AND THE STRING LENGTH TO 
STRINGS. THE. COMPILER THEN COMPUTES THE MAXIMUM MAXIMUM 
VALUE OVER THE ENTIRE LIST, AND THIS IS THE DEFAULT FIELD 
WIDTH FOR THE OUTPUT STATEMENT. FOR EXAMPLE, SUPPOSE THE 
LIST CONSISTS OF A LOGICAL AND A DOUBLE; THEN THE DEFAULT 
FIELD WIDTH WOULD BE 33, SINCE 33=MAX(1,33). THE DEFAULT 
FIELD WIDTH 1S OF COURSE ADJUSTED TO ALLOW R COLUMNS TO 
FIT WITHIN THE RECORD. . 


EXAMPLE: 


PRINT (2)/,0, "STRING", “ANOTHER STRING" ,0.0 


PRODUCING: : 
0, STRING, 


ANOTHER STRING, 0.0, 


3. THE /(W) FORM, AS USED IN PRINT /(15),LIST ETC. THIS 
FORM INSTRUCTS THE I/O SUBSYSTEM TO OUTPUT THE LIST ITEMS 
IN A MANNER SIMILAR TO (2) ABOVE, BUT WITH THE FIELD WIDTH 
OF THE COLUMNS SPECIFIED BY W+e RATHER THAT THE NUMBER OF 


COLUMNS SPECIFIED BY R. THE MAXIMUM FIELD WIDTH AVAILABLE 
FOR EDITING IS W, AND THE NUMBER OF COLUMNS, N, EQUALS THE 
LARGEST INTEGER NOT EXCEEDING RECORDLENGTHINCHARACTERS/ 
(ABS(W)+2), AND NOT LESS THAN ONE. 


(NOTE: IN THE TERMINOLOGY USED HERE, “COLUMN WIDTH" REFERS 
TO THE TOTAL WIDTH OF THE COLUMN -- HERE, W+2, AND IN (2) 
ABOVE C+2 -- AND "MAXIMUM FIELD WIDTH" OR "FIELD WIDTH" OR 
"AVAILABLE FIELD WIDTH" REFERS TO THE WIDTH OF THE COLUMN 
SANS THE @ CHARACTER DELIMETER -- HERE, W CHARACTERS, AND 
IN (2) ABOVE, C CHARACTERS.) 


EXAMPLE : 


PRINT /(10) ,-4.31567243E-14,5.321456789321D12345, . TRUE. 
PRODUC ING: 
—4.3157-14, 5.32+12345, T, 


THE (R)/(W) FORM, AS USED IN PRINT (3)/(20),LIST ETC. 
THIS FORM INSTRUCTS THE 1/0 SUBSYSTEM TO OUTPUT THE LIST 
ITEMS IN A MANNER SIMILAR TO THE COMBINED EFFECTS OF (2) 
AND (3) ABOVE. THE OUTPUT IS COLUMNAR, R COLUMNS W+2 
CHARACTERS WIDE, WITH AN AVAILABLE EDITING FIELD WIDTH OF 
W CHARACTERS. IF (ABS(W)+2)*ABS(R) IS GREATER THAN 
RECORDLENGTHINCHARACTERS, THE VALUE OF W IS DECREASED TO 
THE LARGEST INTEGER GREATER THAN 0 SUCH THAT (W+2)*ABS(R) 
LEQ RECORDLENGTHINCHARACTERS. 


EXAMPLE : 


PRINT (3)/(6) ,-17.216,4.273E+50 ,8.21467D+17898, .FALSE.. 
"TOO LONG" ,0O,184,CMPLX(.3,-4.2) 


PRODUCING: 


-17.22, 4.2+50, D17899, 
F, ##9484, 0, 
184, 0.3, —-4.e2, 
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(NOTE: THE VALUES FOR R AND W ARE IN GENERAL ROUNDED TO 
INTEGERS. A ROUNDED VALUE OF 0 IS EQUIVALENT TO NO VALUE 
SPECIFIED, E.G., (3)/(.2) => (3)/. THE ABS OF R AND WIS 
USED) . 


6, 7, AND 8. 


THE * FORM OF (1), (2), (3), AND (4) ABOVE: */ *C(R)/ 
*¥/(W) *C(RI/(W) AS USED, RESPECTIVELY, IN PRINT */,LIST 
PRINT *(€(4)/7,LIST PRINT */(20),LIST 

AND PRINT *(3)/(15),LIST ETC. THESE FOUR VARIATIONS OF 
FORMS (1)-(4) INSTRUCT THE I/O SUBSYSTEM TO PREFIX EACH 
EDITED LIST ITEM WITH THE SOURCE TEXT OF THE LIST ITEM, 
FOLLOWED BY AN EQUAL SIGN ("="). 


FOR EXAMPLE, LET A=-72.6; THEN PRINT */,A PRODUCES: 
A=-172.6, ; AND PRINT */(5),A PRODUCES: A=-73, . THE 
TEXT TO THE LEFT OF THE EQUAL SIGN (IN THE OUTPUT RECORD) 
IS REFERRED TO AS THE "NAME" OF THE EDITED L.E. IF THE L. 
Bs IS A SIMPLE VARIABLE, AS IN THE ABOVE EXAMPLE, THE 
VARIABLE IDENTIFIER IS USED AS THE NAME. IF THE L.E. IS 
A SUBSCRIPTED VARIABLE, THE VARIABLE IDENTIFIER ALONG WITH 
THE NAME, E.G., RUN-TIME SUBSCRIPT VALUES IS USED AS THE: 
LET A(I,J)=7.8 AND I=3, J=121; THEN PRINT */(11),ACT,J) 
PRODUCES: A(3,121)=8., [NOTE: FOR THE 2.5 RELEASE, 
SUBSCRIPTED VARIABLES WILL BY TREATED AS EXPRESSIONS (SEE 
BELOW), AND WILL BE TREATED IN THE MANNER DESCRIBED ABOVE 
CONCURRENT WITH THE I1.6 RELEASE]. IF THE L.E. IS AN 
ARRAY NAME, THE IMPLICIT OR IMPLIED SUBSCRIPTS ARE 
DISPLAYED ALONG WITH THE ARRAY IDENTIFIER, 

Ev Oia FOR REAL A(3)/-1,-2,-3.4/, PRINT */,A PRODUCES: 
A(1)=-1.0, AlCe)=-2.0, A(3)=-3.4, 


IF THE L.E&. IS A COMPLEX SIMPLE OR SUBSCRIPTED VARIABLE 
OR A COMPLEX ARRAY NAME, A ":R" OR ":I" IS IS APPENDED TO 
THE NAME, DENOTING RESPECTIVELY THE REAL AND IMAGINARY 
PARTS. FOR EXAMPLE, LET C=CMPLX(2.7,1.4E-20), CA(T)=-C, 
AND I=4; THEN PRINT *(2)/,C,CA(@+1/2) PRODUCES: 


DOYe 1 


3, 


A 
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C:R=2.7, | C:1=1.4E-20, 
CA(4):R=-e.7, CAC4) :1=-1.4E-20, 


IN THIS EXAMPLE, EACH FIELD WIDTH IS 30 CHARACTERS. THIS 
IS BECAUSE THE MAXIMUM WIDTH REQUIRED TO EDIT A NAMED L.E. 
IS EQUAL TO THE SUM OF THE MAXIMUM WIDTH REQUIRED TO EDIT 
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THE VALUE (SEE ABOVE) PLUS THE MAXIMUM WIDTH REQUIRED TO - 


EDIT THE NAME (FIVE CHARACTERS IS CONSIDERED THE MAXIMUM 
WIDTH REQUIRED TO EDIT AN INDEX). 


IF THE L.E. IS AN EXPRESSION, THE GENERAL TERM "<EXPR>" 
IS USED AS THE NAME, E.G., LET A=2@; THEN PRINT */,A+4 


PRODUCES: <EXPR>=6.0, . COMPLEX EXPRESSIONS HAVE A ":R" 
OR ":I" SIMILAR TO THE HANDLING OF COMPLEX VARIABLES. 
(NOTE: IT IS HOPED THAT IN THE FUTURE THE ACTUAL 


EXPRESSION TEXT WILL BE USED INSTEAD OF <EXPR>). 


THE * AS APPLIED TO A SPECIFIC LIST ELEMENT: INSTEAD OF 
USING THE * FORMS DESCRIBED ABOVE, WHICH CAUSE A NAME TO 
BE DISPLAYED FOR EACH EDITED LIST ITEM, THE USER CAN 
INSTRUCT THE 1/0 SUBSYSTEM TO DISPLAY ONLY THE NAMES OF 
SELECTED LIST ELEMENTS BY PREFIXING THESE L.E.S WITH AN *. 
FOR EXAMPLE, LET A=e, B=-3, AND C=1.4; THEN PRINT /,A,*B, 
C,*A**B PRODUCES: 2, B=-3,. 1.4, <EXPR>=0.125, . NOTE THAT 
THE * AS APPLIED TO A STRING IS MEANINGLESS. 


LOe tig. 12% 


13, 14, 15, 16. 


THE // FORMS OF (1)-(8) ABOVE: // (R)//. // GW) (R)// (CN) 
¥//  *C(RIS/S  *// (CW) *®CRI// (CW) =AS) ~=USED, RESPECTIVELY, IN 
PRIND #75117). ce 2 PRINT *(5)//(15),LIST ETC. THESE 
EIGHT VARIATIONS PERFORM IDENTICALLY TO THE FORMS (1)-(8), 
WITH THE SINGLE EXCEPTION THAT THE @-CHARACTER DELIMITER 
IS NOT THE ", ", BUT RATHER IS TWO BLANKS. FOR EXAMPLE, 
PRINT //,1,2,3 PRODUCES: 1 @ 3 3; WHEREAS PRINT 
/,1,2,3 PRODUCES: 1, 2, 3, . SINCE THERE ARE NO COMMAS 
SEPARATING THE EDITED LIST ITEMS, THIS FORM OF FREEFIELD 
OUTPUT CANNOT BE READ BY THE / FORM OF FREEFIELD INPUT (A 
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// FORM OF FREEFIELD INPUT WILL BE PROVIDED WITH THE II.6 
RELEASE). 


A NOTE ABOUT STRINGS: SINCE STRINGS MAY BE INPUT UNDER 
FREEFIELD ONLY IF THEY ARE ENCLOSED IN QUOTES, THE USER 
OUTPUTTING STRINGS UNDER FREEFIELD AND INTENDING TO INPUT 
THEM UNDER FREEFIELD MUST INCLUDE THE QUOTES IN THE OUTPUT 
STRINGS, E£.G., THE OUTPUT FROM PRINT /,"STRING" CANNOT 
BE INPUT BY READ /,A; BUT PRINT /,"""STRING""" CAN BE 

INPUT BY READ /,A SINCE THE OUTPUT STRING IS "STRING", 
AND THE VALUE OF A IN THIS CASE WOULD BE GHSTRING. WHEN 
NOT WORKING IN BCL, THE APOSTROPHE CHARACTER MAY BE 
SUBSTITUTED FOR THE QUOTE. OF COURSE, THE HOLLERHTH 
REPRESENTATION MAY BE USED IN EITHER BCL OR EBCDIC, E.G., 
PRINT /,8H"STRING" PRODUCES THE OUTPUT STRING "STRING". 
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NEW FEATURES AND DOCUMENTATION CHANGES 


FORTRAN 


DO310 FORTRAN - LABEL EQUATN OF COMPILER FILES —- 05-07-73 


"MERGE" OR "NEW" MAY BE FOLLOWED BY A’ FILE NAME ENCLOSED IN © 
PARENTHESES. IF THIS IS DONE, THE FILE (TAPE OR’ NEWTAPE 
RESPECTIVELY) WILL BE LOCKED, AND THE TITLE WILL BE CHANGED. 


EXAMPLE : 


SSET MERGE (A/B) NEWC (USER) X/Y.) 
THE TITLE IS LIKE THE TITLE ON LABEL EQUATION CONTROL CARDS. 


DO3e5 FORTRAN - NEW INTRINSICS —- 06-03-73 


THE FOLLOWING NEW INTRINSICS MAY NOW BE REFERENCED IN FORTRAN: 


ATANH ERFC (COMPLEMENTED ERROR FUNCTION 1/ERF) 
DACOS DGAMMA 
DASIN DLGAMA 
DCOSH DS INH 
DERF DTAN 
DERFC DTANH 
DO343 FORTRAN —- SYNTAX ERROR #92 MESSAGE —- 06-24-73 


THIS PATCH ALTERS THE DIAGNOSTIC MESSAGE FOR SYNTAX ERROR #92 TO 
READ: 


"VARTABLE BOUND MUST BE FORMAL OR COMMON ELEMENT" 


DO4e26 FORTRAN - SPACING FOR PROGRAM LISTING = ge zie-ss ee 


DONOR:  PORTRAN! tro SPACING COR PROCRAM ETS TING: 2 Oeslec!s 
THIS PATCH CAUSES THE COMPILER OPTION SINGLE TO BE SET BY DEFAULT 
RESULTING IN SINGLE SPACED LISTINGS. 


THE USER OPTION SINGLEBYDEFAULT CAN BE RESET UPON COMPILATION OF 
FORTRAN TO ALLOW DOUBLE SPACING TO BE THE DEFAULT SETTING. 


DO435 FORTRAN - MISSING SUBROUTINE ERROR MSG - 08-19-73 


THIS PATCH CHANGES THE SYNTAX ERROR MESSAGE "MISSING SUBROUTINE OR 
FUNCTION" TO READ "MISSING SUBROUTINE OR FUNCTION OR END CARD" 
SINCE A MISSING END CARD MIGHT RESULT IN A MISSING SUBPROGRAM 
INDICATION. 


Doe. JOR IR AN: 2 Pa eo res. OPTIMIZATION press 

THIS CHANGE IMPLEMENTS THE HANDLING OF MULTIPLE SUBPROGRAM ENTRY 
POINTS FOR OPTIMIZATION LEVELS GREATER THAN ZERO. NO CODE IS 
SHARED BETWEEN ENTRY POINTS. EACH ENTRY IS ANALYZED AND TREATED AS 
IF IT WERE A SEPARATE SUBPROGRAM. 


pore GOR tRAN 2 Ee eiaey ee - 09-04-73 

A NEW DOLLAR OPTION "LIBRARY" HAS BEEN IMPLEMENTED IN FORTRAN. IT 
IS SIMILAR TO THE OPTION "SEPARATE" EXCEPT ALL OF THE SUBROUTINES 
ARE COMPILED INTO ONE CODE FILE (UNDER "SEPARATE" EACH SUBROUT INE 
AND/OR .MAIN. GOES INTO A SEPARATE CODE FILE). THE TITLE OF THE 
RESULTING CODE FILE WILL BE THE TITLE GIVEN THE CODE FILE ON THE 
COMPILE CARD. THE BINDER HAS BEEN UPDATED SO THAT IT WILL BIND 
SUBROUTINES FROM A LIBRARY FILE. THIS OPTION OFFERS TWO ADVANTAGES 
OVER "SEPARATE": 


DO4YW74 FORTRAN —- LIBRARY OPTION = 09-04-73 mone aL ON 


ONLY ONE FILE OVERHEAD. 


CANDE CANNOT HANDLE THE CASE WHERE THE COMPILER CHANGES 
THE RESULTING CODE FILE TITLE ACCORDING TO THE SUBROUTINE 
NAME. 
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INPUT/ OUTPUT 


PREVIOUS TO THIS PATCH, THE ONLY WAY TO STOP THE SYSTEM FROM 
NEEDLESSLY SEARCHING A TAPE FOR A FILE WAS TO'DS THE PROGRAM. NOW 
IT IS POSSIBLE TO QT THE PROGRAM AND TAPESEARCH WILL REWIND THE 
UNIT WITH LOCK AND GO LOOK ELSEWHERE. 


THE FOLLOWING FILE ATTRIBUTES HAVE BEEN ELIMINATED ON THIS RELEASE : 
1. CODEFILE (56) 


THE 2.1 SYSTEM NOTE MCP #1075 ANNOUNCED THAT THE FILEKIND 
ATTRIBUTE WITH ITS RICHER AND MORE MEANINGFUL SET OF 
VALUES WOULD SUPERSEDE THE FUNCTION OF THE CODEFILE 
ATTRIBUTE. THIS IS NOW BEING ENFORCED BY THE ELIMINATION 
OF THE CODEFILE ATTRIBUTE. 


2. MAXGENNO (68) 


SINCE 2.0 ACCESSING THIS ATTRIBUTE HAS CAUSED A RUN-TIME 
ATTRIBUTE ERROR. NOW, THE ERROR WILL COME AT COMPILE TIME 
WITH A SYNTAX ERROR. 


3. ACCESS (19) 


THE NEED FOR THIS ATTRIBUTE WAS ELIMINATED WITH THE © 
REWRITE OF LOGICALRECORD AT 2.0 AND IT HAS GENERATED RUN 
TIME ERRORS ON THE LAST TWO RELEASES. IT WILL NOW 
GENERATE A COMPILE TIME SYNTAX ERROR. 


4. NEXTRECORD (48) 


PAGE 
THIS ATTRIBUTE HAS NEVER BEEN IMPLEMENTED BECAUSE ADDING 
ONE (1) TO THE VALUE OF THE RECORD ATTRIBUTE PERFECTLY 
SIMULATES IT. INSTEAD OF THE USUAL RUN TIME ATTRIBUTE 
ERROR, THE SYSTEM NOW GIVES A COMPILE TIME SYNTAX ERROR. 
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THE FOLLOWING FILE ATTRIBUTES HAVE BEEN IMPLEMENTED ON’ THIS 
RELEASE : 


Ls 


UPDATEFILE (47) 


BOOLEAN VALUED, SET WHEN FILE IS CLOSED, READ AT 
ANYTIME, MEANINGFUL ONLY FOR DISK FILES. 


THE UPDATEFILE ATTRIBUTE ALLOWS THE USER TO EXPLICITLY 
INDICATE WHEN A DISK FILE IS TO HAVE THE UPDATE I/0 
ACCESSING METHOD. 


WHEN A DISK FILE IS OPEN AND UPDATEFILE IS TRUE, THE 
UPDATE 1/0 METHOD IMPLIES THAT A SERIAL (NON-KEYED) WRITE 
FOLLOWING A SERIAL READ WILL WRITE UPON THE RECORD JUST 
READ (THE NORMAL SERIAL MODE WRITES UPON THE NEXT RECORD 
OF THE FILE). 


TESTING THE ATTRIBUTE WHEN THE FILE IS CLOSED WILL 
INDICATE WHETHER OR NOT THE ATTRIBUTE HAS BEEN SET. WHEN 
THE FILE IS OPENED UPDATEFILE INDICATES WHETHER OR NOT 
UPDATE I/0 ACTION WILL BE PERFORMED UPON THE FILE. 
IRREGUARDLESS OF THE SETTING OF THE ATTRIBUTE, IF THE FILE 
1S ASSIGNED TO A NON-DISK PERIPHERAL UNIT THE VALUE OF THE 
ATTRIBUTE WILL BE FALSE. 


THE UPDATEFILE ATTRIBUTE WILL RETURN TRUE, EVEN IF THE 
ATTRIBUTE WAS SET TO FALSE, IF A DISK FILE IS OPENED WITH 
THE ATTRIBUTE MYUSE SET TO 10. THIS IS AN UNFORTUNATE 
SIDE EFFECT OF THE MYUSE - ATTRIBUTE WHICH HAS NOT BEEN 


CORRECTABLE PREVIOUS TO THIS RELEASE, BECAUSE THERE HAS. 


BEEN NO EXPLICITE WAY TO INDICATE THE DESIRE FOR UPDATE I/ 
O ACTION. THE COBOL COMPILER NOW SETS THE UPDATEF ILE 
ATTRIBUTE WHENEVER A FILE IS OPENED INPUT-OUTPUT AND 
RESETS IT OTHERWISE, SO THAT ALL COBOL PROGRAMS THAT ARE 
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NOW BEING COMPILED WILL NO LONGER BE DEPENDENT UPON THE 
MYUSE SIDE EFFECT. ALGOL PROGRAMS CAN SET THE UPDATEF ILE 
ATTRIBUTE EXPLICITLY IF UPDATE I/70 ACTION IS DESIRED, BUT 
SHOULD BE WARNED ABOUT THE COMBINATION OF MYUSE=I0 AND 
KIND=DISK. 


STATIONSDENIED (103) 


INTEGER VALUED, READ ONLY AND ONLY WHILE THE FILE IS 
OPENED, MEANINGFUL FOR DATACOM (KIND=REMOTE) FILES 
~ ONLY. 


THE STATIONSDENIED ATTRIBUTE RETURNS THE NUMBER OF THE 
STATIONS IN A FAMILY WHICH HAVE BEEN DENIED ASSIGNMENT TO 
THE FILE BY THEIR CONTROLLING MCS(S). 


BECAUSE FILE ASSIGNMENT IS AN ASYNCHRONOUS PROCESS 
REQUIRING THE COOPERATION OF MESSAGE CONTROL SYSTEMS (MCS) 
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THERE IS A POINT IN TIME WHEN THE POPULATION ATTRIBUTE CAN 


RETURN A VALUE OF ZERO (0) BECAUSE THE MCS HAS NOT YET 
REACTED TO THE FILE OPEN REQUESTS. WITH THE HELP OF THE 
STATIONSDENIED ATTRIBUTE A PROGRAM CAN NOW MEANINGFULLY 
INTERPRET THE STATUS OF THE FILE WHEN IT IS USED IN 
CONJUNCTION WITH THE POPULATION AND FAMILYSIZE ATTRIBUTES. 


. CRUNCHED (59) 


BOOLEAN VALUED, READ ONLY AND ONLY WHILE THE FILE IS 
ASSIGNED, MEANINGFUL ONLY FOR DISK FILES. 


THE CRUNCHED ATTRIBUTE INDICATES WHETHER OR NOT A DISK 
FILE HAS RETURNED THE UNUSED PORTION OF THE LAST AREA OF 
THE FILE TO THE SYSTEM. 


THE FOLLOWING CONDITIONS APPLY TO CRUNCHED FILES: 


Le FEES WILL BE CRUNCHED TO A BLOCK BOUNDARY WHERE 
THE BLOCK BOUNDARY IS IN TERMS OF THE BLOCKING 
FACTORS USED TO CREATE THE FILE. 


2. END OF FILE CAN BE EXTENDED ON A CRUNCHED FILE UP - 
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TO THE BLOCK BOUNDARY USED WHEN CRUNCHING. 


3. CRUNCHED FILES CAN BE WRITTEN ON, USING NORMAL 
LOGICAL I/0 ONLY WHEN THE BLOCKSIZE OF THE 
LOGICAL FILE IS EQUAL TO THE BLOCKSIZE USED TO 
CREATE THE PHYSICAL FILE. 


A DISK FILE IS CRUNCHED VIA A CALL ON CLOSE E.G. IN ALGOL 
“CLOSE (FILEID,CRUNCH) ; " 


CODE FILES AND PRINTER BACKUP DISK FILE WILL BE 
AUTOMATICALLY CRUNCHED WHEN THEY ARE CLOSED. 


EXCLUSIVE (90) 


BOOLEAN VALUED, SETTABLE WHILE THE FILE IS CLOSED, 
READABLE AT ANYTIME, MEANINGFUL ONLY FOR DISK FILES. 


THE EXCLUSIVE ATTRIBUTE ALLOWS A PROGRAM TO OPEN A 
PERMANENT DISK FILE AND LOCK OUT ALL OTHER PROGRAMS WHILE 
THE FILE IS OPEN. 


WHEN EXCLUSIVE IS TRUE, A PROGRAM OPENING A PERMANENT DISK 
FILE IMPLICITELY OR THROUGH THE ATTRIBUTES OPEN OR PRESENT 
OR BY A DIRECT CALL ON THE PROCEDURE OPEN (AS DONE IN 
COBOL PROGRAMS) WILL: 


A. GET THE USUAL NO FILE ACTION, IF THE FILE DOES NOT 
EXIST. 


B. GO TO SLEEP, IF THE FILE EXISTS BUT IS ALREADY 
OPENED. 


~C. OPEN THE FILE EXCLUSIVELY, LOCKING OUT ALL OTHER 
PROGRAMS UNTIL THE FILE IS CLOSED. 


WHETHER OR NOT EXCLUSIVE IS TRUE, THE RESIDENT ATTRIBUTE 
WILL RETURN: 


TRUE IF THE FILE EXISTS (LOCKED OUT IS.CONSIDERED 
TRRELEVENT). 


PAGE 109 


FALSE IF THE FILE DOES NOT EXIST. 
5. AVAILABLE (48) 
REAL VALUED, READ ONLY, READABLE AT ANY TIME. 


THE ATTRIBUTE AVAILABLE IS AN EXTENSION OF THE PRESENT 
ATTRIBUTE WHICH MAKES IT POSSIBLE TO DISTINGUISH BETWEEN A 
NO FILE AND A LOCKED OUT FILE CONDITION AND PREVENTS THE 
PROGRAM FROM BEING SUSPENDED IN AN ENVIRONMENT WHERE FILES 
ARE BEING OPENED EXCLUSIVELY. . 


WHEN TESTED AVAILABLE RETURNS: 


0 THE FILE IS LOCKED AND NOT AVAILABLE (I.E., THE 
PROGRAM IS LOCKED OUT) OR IF EXCLUSIVE IS TRUE, 
THE FILE WAS ALREADY OPENED AND ASSIGNED TO 
ANOTHER PROGRAM. 


1 THE FILE IS OPENED AND ASSIGNED TO THE PROGRAM 
(IF THE FILE PREVIOUSLY WAS NOT OPEN, IT WAS 
OPENED) AND IF EXCLUSIVE IS TRUE THE FILE IS NOW 
LOCKED. 


2 THE FILE DOES NOT EXIST. 
THE FOLLOWING ATTRIBUTES HAVE BEEN CORRECTED ON THIS RELEASE: 
1. DIRECTION (27) 


INTEGER VALUED, SET WHEN FILE IS CLOSED (IT MAY BE 
SET AT ANYTIME WITH DIRECT 1/0), READ AT ANYTIME, 
MEANINGFUL FOR TAPE FILES (OR PAPERTAPE WHEN THE MCP 
IS COMPILED WITH REVERSEPAPERTAPE SET). 


THE ATTRIBUTE DIRECTION INDICATES THE DIRECTION IN WHICH 
RECORDS WILL BE ACCESSED FROM A FILE. THE DEFAULT VALUE 
IS FORWARD (0). TO READ A TAPE FILE WHEN DIRECTION IS 
REVERSE (1) WITH NORMAL I/0, THE TAPE MUST BE PROPERLY 
POSITIONED AT THE END OF THE FILE BEFORE IT IS OPENED. 
DIRECT I/0 CAN CHANGE DIRECTION AT ANYTIME, AS LONG AS THE 
FILE HAS NOT SEEN A TAPE MARK. DIRECT I/0 MUST CLOSE THE 
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FILE TO MOVE PAST A TAPE MARK. 


EOF (36) 
GENERAL, READ ONLY, OPENED, BOOLEAN 


THE ATTRIBUTE EOF INDICATES WHETHER OR NOT (TRUE OR FALSE) 
END OF FILE HAS BEEN REACHED. DEPENDING ON THE ASSIGNED 
PERIPHERAL UNIT (KIND) IT MAY BE POSSIBLE TO "RESET" EOF 
BY ACCESSING A VALID RECORD. THIS MAY BE DONE BY USING A 
RANDOM READ OR WRITE OR BY "BACKSPACING". 


BLOCK (44) 
DISK/TAPE, READ ONLY, ANYTIME, INTEGER 


THE ATTRIBUTE BLOCK RETURNS THE NUMBER OF THE BLOCK IN THE 
FILE REFERENCED IN THE LAST 1/70 STATEMENT. WHEN THE FILE 
IS CLOSED, OR IF THE FILE IS OPEN BUT NO 1/0 HAS BEEN 
PERFORMED, BLOCK WILL RETURN MINUS ONE (-1). BLOCK WILL 
ALSO RETURN MINUS ONE (-1) AFTER AN ATTEMPTED 1/0 BEYOND 
THE END OF THE FILE. THE COUNTING OF BLOCKS IS ZERO 
RELATIVE, THAT IS TO SAY, THE FIRST BLOCK IN A FILE IS 
BLOCK ZERO (0). 


THE OPERATION OF THE FOLLOWING ATTRIBUTES HAS BEEN CHANGED. 


1. 


OTHERUSE (21) 


THE OTHERUSE ATTRIBUTE HAS NEVER BEEN’ IMPLEMENTED. 

HOWEVER, IT HAS BEEN POSSIBLE TO SET AND READ THE VALUE OF 
THE ATTRIBUTE EVEN THOUGH THE SYSTEM MADE NO USE OF IT. 
TO ELIMINATE THE CONFUSION (SEE TAR’ 10034 AND 10229) 
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CAUSED BY THIS SITUATION, THE ATTRIBUTE TABLE HAS BEEN 


MODIFIED SO THAT EITHER SETTING OR ACCESSING THE OTHERUSE 
ATTRIBUTE WILL GENERATE A NON-FATAL ATTRIBUTE ERROR. 


USEDATE (61) 


THE ATTRIBUTE USEDATE WILL NOW ONLY BE CHANGED IF A FILE 
IS ACTUALLY OPENED, OR EXECUTED IN THE CASE OF CODE FILES. 
LIBRARY MAINTENANCE FUNCTIONS WILL NO LONGER ALTER ACCESS 
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poner =MCRr1=O = DIRECT I-O CHARACTR DISK FILES ~ 08-12-73 

THIS PATCH IMPLEMENTS DIRECT 1/0 CHARACTER ORIENTED DISK FILES. 
THE USER SHOULD NOTE THAT THE SIZE PARAMTER IN A DIRECT 1/0 READ OR 
WRITE STATEMENT IS ALWAYS IN THE FORM WORDS AND CHARACTERS IN THE 
LAST WORD. THE FIELDS ARE WORDCOUNT = [16:17] AND CHARACTERS = 
[19:03]. 


WOES. ee elo. Sy eee oeg es ee ee cee LOWED 2 Ue as 

THE TESTS IN OPEN TO PREVENT THE CREATION OF UNLABELED PUNCH FILES 
WAS INCORRECTLY PREVENTING LABELTYPE=STANDARD FILES FROM BEING 
CREATED. THIS PATCH UNIFORMLY PREVENTS THE CREATION OF PUNCH OR 
PUNCH BACKUP FILES WHEN LABELTYPE=OMITTED OR OMITTEDEOF (UNLESS IT 
IS A DIRECT 1/0 FILE). 
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NEW FEATURES AND DOCUMENTATION CHANGES 


JOBFORMATTER 


THIS CHANGE ADDS THE JOB OR TASK NAME AND THE USERCODE TO THE 
INFORMATION PRINTED IN THE END OF JOB AND END OF TASK PRINTOUTS. 


NEW FEATURES AND DOCUMENTATION CHANGES eAge: “Eke 


LISTOIRECTORY 


DOs4u4 = LISTDIR - DIRECTORY LISTING REPORTS — O67e4NTS 

MAJOR CHANGES HAVE BEEN MADE IN THE PRODUCTION OF THE “HIERARCHICAL 
DIRECTORY STRUCTURE". PRE-2.2 DIRECTORIES ARE NO LONGER HANDLED 
AND THE HANDLING OF NEWER ONES HAS BEEN REWRITTEN. 


THERE IS A NEW REPORT, THE SORTED HIERARCHICAL DIRECTORY REPORT, 
WHICH PUTS SEGMENT SIZES (TOTAL CONTROLLED BY A DIRECTORY) ON THE 
LEFT AND ORDERS THIS INFORMATION BY SIZE. DIRECTORIES ARE SORTED 
ON THE NUMBER OF SEGMENTS THEY CONTROL AND ALL OTHER FILES ON 
SEGMENTS USED. THE BASIC TREE STRUCTURE IS RETAINED, WITH THE 
LARGEST BRANCH APPEARING FIRST, THEN THE LARGEST LIMB DESCENDING 
FROM IT, ETC. 


TASK VALUES (VALUE = N OR DIR N) ARE DEFINED AS FOLLOWS: 


QO: ‘DEFAULT. CASE. GIVES ALL REPORTS AND TAKES THE LONGEST 
TIME. REPORTS PRODUCED ARE: 


HIERARCHICAL DIRECTORY 
SORTED HIERARCHICAL DIRECTORY 
DISK MAP BY FILE. . 
FILE MAP BY AREA ADDRESS 

DISK CHECKERBOARD 

FILE CONFLICTS (IF. ANY) 

STATUS OF DISK SWITCHES 


OarWDs 


~] 


! PRODUCES ONLY BEGORT NUMBER ONE. FASTEST AND TAKES LEAST 
PAPER. 


2 PRODUCES REPORTS NUMBER ONE AND NUMBER TWO ONLY. 
RESETTING "LINES" RESULTS IN OUTPUT AT SIX LINES PER INCH. 
THE DEFAULT PAGE SIZE FOR OUTPUT IS 81 LINES INCLUDING HEADINGS, IF 
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AT EIGHT LINES PER INCH AND 58 LINES IF AT SIX LINES PER INCH. THE 
SIZE IS NOW CONTROLLED BY THE "“PAGESIZE" ATTRIBUTE OF THE PRINTER 
FILE "LINE" AND MAY BE CHANGED AT RUN TIME BY A FILE CARD. A 
"PAGESIZE" OF ZERO SETS THE LOGICAL PAGE TO 65,534. 


THE VERSION AND CYCLE NUMBERS HAVE BEEN ADDED TO THE HEADING LINE. 


D0379 LISTDIR - INCREASED SPEED OF LISTDIR - 07-08-73 

A NEW TECHNIQUE OF PRODUCING THE HIERARCHICAL DIRECTORY HAS 
RESULTED IN A SPEED UP OF APPROXIMATELY SIX TO ONE. THIS IS 
ACCOMPLISHED BY HAVING THE MCP PRODUCE A FILE CONTAINING THE 
SYSTEMDIRECTORY FILE AND ALL ASSOCIATED HEADERS WITHOUT OPENING AND 
CLOSING THE FILES INVOLVED. THIS FILE IS THEN PROCESSED BY SYSTEM/ 
LISTDIRECTORY USING DIRECT I/O. THE MCP COPY REQUEST (A CALL UPON 
GETSTATUS) WILL TERMINATE THE JOB IF IT ATTEMPTS TO VIOLATE 
SECURITY. HENCE, SYSTEM/LISTDIRECTORY MUST BE RUN UNDER A. 
PRIVILEGED USERCODE. SEE DO4Ye5 FOR THE NEW SYNTAX OF DIR WHICH 
ALLOWS INTRODUCTION OF THE PRIVILEGED USERCODE. FINALLY, NO FILES 
MAY BE ADDED OR REMOVED FROM THE SYSTEM WHILE THE COPY IS TAKING 
PLACE (APPROXIMATELY 200 FILES/SECOND). 


LISTDIRECTORY NOW REPORTS THE CORRECT SIZE OF CRUNCHED DISK FILES. 
PLEASE REFER TO MCP DO410 FOR A MORE DETAILED EXPLANATION OF 
CRUNCHED FILES. 


AN END OF FILE NUMBER LABEL NO LONGER OCCURS ON THE LINE~PRINTER IF 
THERE IS MORE THAN ONE PAGE OF CONFLICTS. 


CONFLICTING ROW NUMBERS ARE NOW GIVEN IN ADDITION TO THE FILE 
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NUMBER. 


DO4WS3 LISTDIR - NEW APL AND BASIC FILELYPES: = 08-26-73 


THIS CHANGE ADDS THE FILE TYPES APLDATA (195), APLWORKSPACE (196), 
CDATA (192), AND CSEQDATA (198) TO THE LIST OF KNOWN FILE TYPES. 


DOYS1 LISTDIR’ - IDENTIFICATN OF CRUNCHED FILE - 10-16-73 


CRUNCHED FILES ARE NOW IDENTIFIED AS SUCH FOLLOWING THE NUMBER OF 
SEGMENTS IN THE FILE. 


PAGE 
NEW FEATURES AND DOCUMENTATION CiiANGES re 
LISTFILES 
DOH81 LISTFILES = USER OPTIONS IN LISTFILES = 08-26-73 
ae 
f 
identifier 3 —= modifier 
file attribute 
control option 
SYNTAX FOR MODIFIED LFILES . 
| WHEN A ":" APPEARS IN THE INPUT PARAMETER LIST, WHAT FOLLOWS IS 


TAKEN AS USER-SUPPLIED OPTIONS UNTIL THE END OF INPUT. IF THE 


COLON APPEARS, ALL OPTION REPORTING IS PRESET TO FALSE. 


ONLY 


SUFFICIENT CHARACTERS TO UNSURE UNIQUENESS NEED BE SUPPLIED FOR 
EACH OPTION. UNRECOGNIZED SPELLING OR INSUFFICIENT ‘CHARACTERS 


RESULT IN A WARNING MESSAGE. 


IN ADDITION TO THE DATA FILE ATTRIBUTES SHOWN ARE THE FOLLOWING 


CONTROL OPTIONS: 
ABBREVIATED SHORTENS ALL FILE OPTION IDENTIFICATION. 


ALL SETS ALL DATA FILE ATTRIBUTE REPORT ING TO TRUE. 


DOUBLE DOUBLE SPACES THE OUTPUT. 


DOWG1 LISTFILES - USER OPTIONS IN LISTFILES - o8-26-73°F 11’ 
EXAMPLES: 

LFILES X: AREAS AREASIZE U MAX MIN BL ABBREVIATED | 

LFILES : ALL DOUBLE ABB 

LFILES (NOTME): FILETYPE DATE DO 

LFILES A/B: CREATIONDATE, LASTA, LASTR, AB, D 


NOTE: "D" HAS NOT SUFFICIENT CHARACTERS FOR UNIQUENESS AND HENCE 
RESULTS IN A WARNING MESSAGE. 


. PAGE 118 
NEW FEATURES AND DOCUMENTATION CHANGES 


LOADER 


DO382 LOADER - DAMAGED DIRECTORY-FILE RECOVRY - 07-08-73 


THIS CHANGE IMPLEMENTS RECOVERY FROM DAMAGED DIRECTORY AND FILES.. 
SYNTAX 


1. THE LOADER DATA CARD "CGOLSTART" INVOKES DIRECTORY COMPLEMENT. 
2. THE LOADER DATA CARD "REMOVE" REMOVES THE INDICATED FILE. 


REMOVE<MULTI-FILE ID> | 
<MULTI-FILE ID>::= <FILE ID> / <MULTI-FILE I1D>/<FILE ID> 
<FILE ID>::= <IDENTIFIERS OF 17 OR LESS CHARACTERS> 


SEMANTICS 


1. COOLSTART 


THIS OPTION WILL SIMULATE THE MCP"S PROCEDURE 

"DIRECTORYCOMPLEMENT" IN THE LOADER. IT WILL CATCH ANY I/0 
THAT RESULTS IN DISK I/O ERRORS (PARITY, TIMEQUT, ETC.). IT 
WILL CHECK ROW ADDRESSES OF ALL HEADERS FOR VALID EU AND 
ADDRESS FIELDS. (THE EU MUST BE ON THE LINE, THE ADDRESS 
MUST BE WITHIN RANGE FOR THIS TYPE EU, IAD FILES POINTING TO 
NON-EXISTING DISK WILL CAUSE PROBLEMS). IT WILL NOT CHECK 
FOR OVERLAPPING FILES ("DIRECTORY DAMAGED" WILL NOT CAUSE THE 
HALT/LOAD TO FAIL AND DAMAGED FILES CAN BE REMOVED AFTER A 
LISTDIRECTORY). IF AN ERROR OCCURS WHILE LOOKING THROUGH THE 
DIRECTORY, THE CURRENT FILE OR DIRECTORY THAT IS BEING LOOKED 
AT WILL BE DISPLAYED ON THE CONSOLE AND AN “OK" MUST BE 
ENTERED TO REMOVE THE FILE OR DIRECTORY. AFTER THE DIRECTORY 
OR FILE IS REMOVED, THE LOADER WILL TRY AGAIN STARTING AT THE 
BASE OF THE DIRECTORY. IF A RESPONSE IS NOT SEEN INDICATING 
THE FILE HAS BEEN REMOVED (LOADER STARTS DUMPING), THIS MEANS 


DO382 LOADER - DAMAGED DIRECTORY-FILE RECOVRY - 07-08-73" ee 
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THE HEADER OR DIRECTORY CANNOT BE REMOVED AND THE PREVIOUS 
DIRECTORY MUST BE REMOVED USING THE "REMOVE" CARD. ANOTHER 
POSSIBLE RESPONSE WHILE TRYING TO REMOVE THE HEADER IS: 


"DISK ERROR WHILE TRYING TO REMOVE HEADER OR DIRECTORY... 
USE REMOVE CARD TO REMOVE PREVIOUS DIRECTORY". 


2. REMOVE 


THE REMOVE OPTION ALLOWS A HEADER OR DIRECTORY TO BE REMOVED 
FROM THE SYSTEM. IF THE HEADER OR DIRECTORY CANNOT BE FOUND, 
THIS FACT WILL BE DISPLAYED. A MESSAGE IS DISPLAYED FOR 
SUCESSFUL REMOVAL. 


THE LOADER REQUIRES TWO MEMORY MODS, MOD ZERO AND ANY OTHER MOD TO 
BE ON-LINE. 


Bpe32, “LOADER (2 DIRECTORY “COMPLEMENT “TIMINGS = O7elta7s 

IN ADDITION TO INDICATING WHEN THE DIRECTORY COMPLEMENT 1S STARTED 
AND ENDED, THE SYSTEM/LOADER WILL ALSO GIVE THE TIME IN MINUTES AND 
SECONDS AS TO DURATION OF DIRECTORY COMPLEMENT AND ALSO A DIRECTORY 
FILE COUNT WILL BE DISPLAYED ON THE CONSOLE. 


DO4O8 LOADER - UPDATED SOFTWARE LEVEL - 07-29-73 


THIS PATCH ADDS CERTAIN FEATURES TO THE SYSTEM/LOADER. 


1. UPDATES SOFTWARE LEVEL SO THAT IT IDLES WITH "ew TINE Ay 
X, BAND Y PROCESSOR REGISTERS AND SPO MESSAGE LEVEL IS 
UPDATED FROM "2.4" TO "2.5". 


e. LOCATIONS OF SYSTEMDIRECTORY AND MCPINFO ARE DISPLAYED ON 
THE CONSOLE WHEN THE LOADER READS A PARAMETER CARD WHICH 
HAS THE WORD "LOCATIONS" ON IT. 


DO¥O8 LOADER - UPDATED SOFTWARE LEVEL - 07-29-73 PAF TEP 


3. AS THE LOADER FINDS THE PROPER FILE TO LOAD, IT WILL 
DISPLAY THE MESSAGE "***LOAD <FILE ID>***". 


DO428 LOADER - DIRECTORYLOC AND DIRECTORYROW - 08-12-73 
THIS PATCH REMOVES THE ABILITY TO SPECIFY DIRECTORY LOCATION AND 
DIRECTORY ROW SIZE IN LOADER AT COLD START TIME. 


DO53e LOADER - RESERVE SU OR SWITCHES — 09-23-73 


THE LOADER "RESERVE" PROCEDURE HAS BEEN CHANGED TO ASSUME THAT UNIT 
(SU) AND SWITCH NUMBERS (SWITCH) ORIGINATE AT "1" FOR TYPE I DISK. 
THIS MAKES THE LOADER "RESERVE" CONFORM TO THE CONSOLE "RES" AND 
"RET". 


NEW FEATURES AND DOCUMENTATION CHANGES RAGES «det 


LOGANALYZER 


DO331 LOGANALY - COPY AND COMPARE ERRORS - 06-03-73 


THIS CHANGE IMPLEMENTS THE ABILITY FOR LOGANALYZER TO PRINT OUT 


LIBRARY MAINTENANCE COPY AND COMPARE ERRORS, WHICH THE MCP NOW PUTS . 


IN THE SYSTEM LOG. THE RECORDS WILL BE PRINTED OUT ON ANY LOG 
MAINTENANCE COMMAND. SEE MCP DOS4S8. 


DO345  LOGANALY = DUMP AND UNKNOWN OPTIONS = 06-24-73 

TWO NEW OPTIONS HAVE BEEN ADDED TO LOGANALYZER - DUMP AND UNKNOWN. 
"DUMP" RESULTS IN A DUMP OF ALL SELECTED RECORDS IN THE LOG (AS 
OPPOSED TO "RAW", WHICH DUMPS THE WHOLE LOG). "UNKNOWN" RESULTS IN 
A DUMP OF ALL RECORDS IN THE LOG WHICH LOGANALYZER DOES NOT 
RECOGNIZE. 


DO346 = LOGANALY = UNSORTED OPTION = 06-24-73 

A NEW OPTION HAS BEEN ADDED TO SYSTEM/LOGANALYZER WHICH ALLOWS 
PRINTING THE LOG ENTRY IN SEQUENTIAL ORDER INSTEAD OF SORTED BY 
RECORD TYPE AS IS DONE NORMALLY. THE PARAMETER “UNSORTED” MAY BE 
SPECIFIED IN ADDITION TO OTHER PARAMETERS IN ORDER TO OBTAIN AN 
UNSORTED LOG PRINTOUT. 


DO347  LOGANALY = MIX OPTION — 07-08-73 

THE DESCRIPTION OF THE "MIX" OPTION IN THE WFM REFERENCE MANUAL (P. 
5-3) IS INCORRECT. IT SHOULD STATE THAT "LOG MIX <MIX NUMBER>" 
GIVES ALL RECORDS ASSOCITED WITH THE <MIX NUMBER>. (ADDITIONAL 


PA 
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CRITERIA (BOJ, EOJ, IOERROR, ETC.) MAY BE USED IN ADDITION TO 
PRINT ONLY THE DESIRED ENTRIES FOR THE <MIX NUMBER>.) 


DOve9 =LOGANALY = JOERROR LOG HEADING — O87 len73 

THE COLUMN LABELED "TIME" ON THE IO ERROR LOG PRINTOUT HAS BEEN 
CHANGED TO “SCNO TIME" IN ORDER TO POINT OUT THE FACT THAT THIS IS 
THE ACTUAL TIME THAT THE IO OPERATION WAS INITIATED RATHER THAN THE 
TIME THAT THE ERROR RECORD WAS LOGGED. 


pows4  LOGANALY - LOG TASKS WITH ERRORS - 08-26-73 

A NEW SPECIFICATION, "ERRORS", HAS BEEN ADDED TO LOGANALYZER. WHEN 
THIS OPTION IS SET, ONLY THOSE TASKS WHICH WERE DS-ED OR WERE 
COMPILATIONS WITH SYNTAX ERRORS WILL BE PRINTED OUT. 


DO533 LOGANALY - LOG PROCESSOR ERRORS = 07-23-73 

THE CAPABILITY TO ANALYZE LOG RECORDS CREATED BY THE PROCESSOR 
VERIFICATION ROUTINES TO REPORT ANY PROCESSOR FAILURES HAS BEEN 
ADDED TO LOGANALYZER. THESE RECORDS MAY BE PRINTED BY "LOG MAINT" 
OR "LOG CPUERROR". 7 


NEW FEATURES AND DOCUMENTATION CHANGES PAGE 123 


MCP 


D0291 MCP - RESERVE SYNTAX EXAMPLES - 04-23-73 


RESERVE SYNTAX EXAMPLES AS NOTED IN THE MARK I1.3 SYSTEM 
MISCELLANEA ON PAGE 191, EXAMPLES THREE AND FIVE, SHOULD NOT 
INCLUDE THE WORDS "AS BADDISK". 


THIS SYSTEM NOTE DESCRIBES THE NEW VERSION OF DISKPACKINITIALIZE 
(CALLED DPI FOR BREVITY), THE BASIC PURPOSE OF DPI AND THE 
IMPROVEMENTS MADE IN THE NEW ROUTINE. FOLLOWING THIS WILL BE A 
DETAILED DISCUSSION OF THE I/0 ERROR ANALYSIS DONE BY DPI. 


pee 

DPI IS CALLED BY DISKPACKER WHEN THE OPERATOR INPUTS A IV COMMAND. 
IT IS PASSED A’ SINGLE PARAMETER, THE UNIT NUMBER OF THE SPINDLE 
CONTAINING THE PACK TO BE INITIALIZED. DPI FORMATS THE PACK WITH 
30-WORD RECORDS, ANALYZES THE SURFACE FOR BAD SPOTS, CONSTRUCTS THE 
MASTER AVAILABLE TABLE, AND MARKS THE PACK AS INITIALIZED. 


DPI MAKES TWO PASSES OVER THE GIVEN PACK. DURING THE FIRST PASS AN 
INITIALIZE COMMAND 1S USED TO PREFORMAT EACH TRACK WITH 30-WORD 
RECORDS. DURING THE SECOND PASS A VERIFY COMMAND IS USED TO TEST 
EACH RECORD WRITTEN DURING THE FIRST PASS. DPI .ATTEMPTS TO 
RELOCATE BAD SECTORS TO THE SPARES PROVIDED ON TRACK ZERO OF EACH 
CYLINDER. IF THIS CANNOT BE DONE, THE TRACK IS AUTOMATICALLY XD-ED. 
DPI PRODUCES A REPORT INDICATING I/0 ERRORS ENCOUNTERED, WHAT 
SECTORS WERE RELOCATED, AND WHAT TRACKS AND CYLINDERS WERE XD-ED. 


AGE 124 
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DPI WAS COMPLETELY REWRITTEN. SEVERL IMPROVEMENTS WERE MADE IN THE 
ROUTINE, THE MOST IMPORTANT ONE BEING THAT THE NEW ROUTINE PERFORMS 
A CAREFUL ANALYSIS OF DISKPACK 1/0 ERRORS. SPECIFIC IMPROVEMENTS 
ARE AS FOLLOWS: 


1. THE INITIALIZE AND VERIFY COMMANDS ARE ISSUED IN THE 
CYLINDER MODE RATHER THAN THE FULL PACK MODE. THIS BREAKS 
THE PROCESS DOWN INTO 812 HALF-SECOND OPERATIONS RATHER 
THAN TWO FOUR-MINUTE OPERATIONS. , 


2. A PRINTED REPORT IS PRODUCED THAT SERVES AS A PERMANENT 
RECORD OF THE PHYSICAL CONDITION OF THE PACK. THIS LIST 
COULD PROVE USEFUL WHEN TRYING TO ANALYZE 1/0 ERRORS LATER 
ON THE PACK (E.G., RELOCATED SECTORS COULD BE IDENTIFIED). 


Le A DETAILED ANALYSIS IS MADE OF ALL I/O ERRORS ENCOUNTERED. 
THIS ANALYSIS IS DISCUSSED MORE FULLY BELOW. 


4. PROVISION WAS MADE FOR THE 225 DISK PACKS. SEVERAL GLOBAL 
DEFINES WERE ADDED TO THE MCP TO EXTRACT THE VARIOUS SIZE 
PARAMETERS FOR’ THE DEVICE. THESE PARAMETERS INCLUDE: 
SPARES PER CYLINDER, CYLINDERS PER PACK, SECTORS PER 
CYLINDER, AND SECTORS PER TRACK. 


DEFINITIONS 

THIS) DESCRIPTION SUPERSEDES THE DISK PACK MANUAL REGARDING THE 
ADDRESSING OF PHYSICAL DISK-PACK RECORDS. THE FOLLOWING STANDARD 
1S PROPOSED AND WILL BE FOLLOWED CONSISTENTLY. 


SECTOR NUMBER THE RELATIVE POSITION (STARTING FROM ZERO) OF 
THE GIVEN SECTOR WITH RESPECT TO THE INDEX POINT 
ON THE TRACK. FOR EXAMPLE, THE SECTOR NUMBERS 
OF A 215 PACK FORMATTED WITH STANDARD 30- One 
RECORDS RANGE FROM ZERO TO 3e. 


SEGMENT ADDRESS THE DISK ADDRESS USED IN READ AND WRITE COMMANDS 


BAGE led 
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FOR THE GIVEN SECTOR. FOR EXAMPLE, THE SEGMENT 
ADDRESSES OF A 215 PACK FORMATTED WITH STANDARD 
30-WORD RECORDS RANGE FROM ZERO TO 265929. 
NOTICE, IN THIS CASE, THAT: 


1. THE FIRST SECTOR ON CYLINDER ZERO TRACK 
ZERO IS ZERO. 


e. THE FIRST SECTOR ON CYLINDER ZERO TRACK 
ONE IS 28. 


3. THE FIRST SECTOR ON CYLINDER ZERO TRACK 
TWO IS 61. 


4. THE FIRST SECTOR ON CYLINDER ONE TRACK 
ZERO IS 655. 


1/0 ERROR PROCESSING 


I/O ERRORS ARE DETECTED AND PROCESSED BY DPI AS FOLLOWS: 


1. DISKWAIT OR WAITIO IS: CALLED TO ISSUE THE PRIMARY I/0 
REQUEST. 


e. IF THE RESULT DESCRIPTOR FROM EITHER OF THESE ROUTINES 
INDICATES AN ERROR (BIT ZERO IS A ONE), THE NEW GLOBAL MCP 
PROCEDURE, PACKERRMSG, IS CALLED TO CONSTRUCT AN ERROR 
MESSAGE AND CLASSIFY THE ERROR. 


3. THE ERROR MESSAGE IS PRINTED. IF WAITIO WAS CALLED, THE 
ERROR MAY BE RETRIED UP TO FIVE TIMES AT THIS POINT. 


4, IF THE ERROR PERSISTS, DPI MAY MARK THE TRACK AS BAD (XD 
bos, seis THE COURSE OF ACTION DEPENDS ON THE CLASS OF 
ERROR AND WHERE IT OCCURS. SINCE THE PROCESSING OF THE 
ERROR CONDITION DEPENDS ON WHAT ITS CLASS IS, PACKERRMSG 
WILL BE DESCRIBED FIRST. 


PACKERRMSG 


PACKERRMSG IS A NEW GLOBAL MCP PROCEDURE THAT CONSTRUCTS DISK-PACK 


I/O ERROR MESSAGES AND CLASSIFIES THE ERROR CONDITION. IT IS 
CURRENTLY INTENDED FOR THE USE OF DISKPACKINITIALIZE, 
DISKPACKPWROFF , DISKPACKCONF IGURE, AND READPACKLBL. THE ROUTINE IS 
PASSED SEVERAL PARAMETERS: 


1. AN 8-BIT POINTER TO THE 100-BYTE BUFFER THAT IS TO RECEIVE 
THE ERROR MESSAGE. 


THE RESULT DESCRIPTOR FROM WAITIO OR DISKWAIT. 


2 
3. THE STARTING SEGMENT ADDRESS, INCLUDING THE UNIT NUMBER. 
4. THE ORIGINAL I/0 COMMAND. 

uy 


A CODE INDICATING THE NAME OF THE CALLER. 


THE MESSAGE CONSTRUCTED IN THE BUFFER INCLUDES THE NAME OF THE 
CALLER, THE PACK UNIT NUMBER, THE RESULT DESCRIPTOR AND COMMAND IN 
HEX, THE STARTING SEGMENT ADDRESS, THE STARTING CYLINDER AND TRACK, 
AND A TEXT DESCRIPTION OF THE ERROR CONDITION (E£.G., SEEK TIME 
OUT). PACKERRMSG RETURNS A’ VALUE INDICATING THE CLASS OF ERROR 
DETECTED. THIS IS INTENDED PRIMARILY FOR DISKPACKINITIALIZE AND 
ATTEMPTS TO DISTINGUISH BETWEEN ERRORS CAUSED BY THE 1/0 EQUIPMENT 
os ee ae DRIVE, CONTROLLER, AND CHANNEL), THE PROGRAM OR OPERATOR, 
AND THE PACK ITSELF. THE ERRORS HAVE BEEN CLASSIFIED AS FOLLOWS: 


1. PROGRAM OR OPERATOR ERROR -- VALUE ONE 


MEMORY PROTECT, MEMORY ADDRESS, NOT READY OR SELECT 
LOCK, CONTROLLER IN LOCAL, WRITE LOCK OUT: 


e. SOLID EQUIPMENT ERROR (CONTROLLER OR CHANNEL) -— VALUE TWO 


MEMORY PARITY, DESCRIPTOR ERROR, CONTROLLER BUSY, 
CONTROLLER MALFUNCTIONING, MEMORY ACCESS, TRANSMISSION 
PARITY, INTERFACE PARITY, FIRST ACTION, DRIVE.SEEKING, 
SEEK INITIATED, SEEK TIME OUT, DRIVE BUSY, UNKNOWN 
(UNLISTED RESULT DESCRIPTOR BIT COMBINATION). . 


3. PROBABLE DISK DRIVE ERROR -- VALUE THREE 
SPEED ERROR, SECTOR TIME OUT, SEEK ERROR. 


D0299 MCP 
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4. PROBABLE PACK ERROR -- VALUE FOUR 


ADDRESS PARITY, 


ADDRESS POSITION, 


DATA ERROR RETRY, 


DATA ERROR CORRECTION. 


DISKPACKINITIALIZE 1/0 ERROR PROCESSING 


THE ACTION 
ERROR 


TRACK IN QUESTION 


FOLLOWS: 
ERROR CONDITION 


CLASS ONE OR TWO, OR 
THREE ERROR DURING 
INITIALIZE PASS. 


CLASS FOUR ERROR 
DURING INITIALIZE 
PASS. 


CLASS ONE OR TWO ERROR 
DURING VERIFY PASS. 


CLASS THREE OR FOUR 
ERROR DURING VERIFY 
PASS AND NO SEGMENT 
ADDRESS REPORTED. BY 
CONTROLLER. 


CLASS THREE OR FOUR 
ERROR DURING VERIFY 
PASS AND SEGMENT 
NUMBER REPORTED BY 
CONTROLLER. 


TAKEN BY DPI 
AND THE COMMAND BEING PERFORMED. 
TWO ERROR CAUSES AN IMMEDIATE ABORT, 
TO BE 
SECTOR TO BE RELOCATED TO A 


AFTER AN ERROR DEPENDS ON THE CLASS OF 

IN GENERAL, A CLASS ONE OR 
CLASS THREE ERRORS CAUSE THE 
XD-ED, AND CLASS FOUR ERRORS CAUSE THE 
SPARE . THE EXACT ACTIONS ARE AS 


ACTION TAKEN 


ABORT IV WITH RETURN CODE OF Ye. 


CAUSE ENTIRE CYLINDER TO BE REMOVED FROM 
MASTER AVAILABLE TABLE (MAT), IF ERROR 
IS ON CYLINDER ZERO, ABORT RUN. 


ABORT IV WITH RETURN CODE OF 44. 


REPEAT VERIFY PASS OVER CYLINDER A SINGLE 
TRACK AT A TIME. WHEN ERROR REOCCURS. 
REMOVE TRACK FROM MAT. 


IF SEGMENT IN’ ERROR IS A SPARE, INDICATE 
THERE ARE NO SPARES AVAILABLE ON CYLINDER 
AND CONTINUE. IF ERROR IS ON TRACK ZERO 
OF THE CYLINDER, VERIFY THE REST LOCATED 
AT THE END OF THE TRACK). IF THAT FAILS 
FOR ANY REASON. REMOVE TRACK ZERO FROM 
THE MAT AND INDICATE THAT THERE ARE NO 
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SPARES AVAILABLE ON THE CYLINDER. 
OTHERWISE, OR IF ERROR WAS NOT TRACK 
ZERO, RELOCATE THE SECTOR TO A SPARE AND 
REVERIFY THE TRACK (TO MAKE SURE THE 
RELOCATE WORKED). IF THERE ARE NO MORE 
SPARES AVAILABLE ON THE CYLINDER, REMOVE 
THE TRACK FROM THE MAT. ° 


ANY ERROR DURING REMOVE TRACK CONTAINING SEGMENT BEING 
RELOCATE. RELOCATED FROM MAT. 
ANY ERROR WRITING MAT ABORT RUN. 


OR LABEL ON PACK. 


THE GOAL OF THIS ERROR PROCEDURE IS TO ONLY ALLOW TRACKS THAT COULD 
BE COMPLETELY VERIFIED FROM START TO FINISH IN THE MAT. IF A TRACK 
CONTAINS RELOCATED SECTORS, THAT IS FINE, AS LONG AS THE ENTIRE 
TRACK COULD BE REVERIFIED AFTER RELOCATION. THERE ARE TWO 
EXCEPTIONS TO THIS: 


1. IF TRACK ZERO CONTAINS A RELOCATED SECTOR, A VERIFY FOR 
TRACK ZERO WILL ALWAYS RETURN AN ADDRESS POSITION ERROR 
WHEN IT REACHES THE SPARE THAT WAS ASSIGNED. THIS ERROR 
IS IGNORED. 


2. IF A RELOCATE COMMAND FAILS, THE TRACK CONTAINING THE 
SEGMENT TO BE RELOCATED IS XD-ED. HOWEVER, IT IS STILL 
POSSIBLE THAT A SPARE ON TRACK ZERO WAS IN ERROR AND MIGHT | 
HURT FUTURE TRACK - ZERO 1/0. (AT LEAST TRACK ZERO WAS 
COMPLETELY VERIFIED ONCE, SO LATER DAMAGE COULD BE 
CLASSIFIED AS BAD LUCK, SO TO SPEAK.) 


NO ATTEMPT IS MADE TO XD INDIVIDUAL SEGMENTS (AS THE ORIGINAL 
ROUTINE DID WHEN IT RAN OUT OF SPARES) BECAUSE THERE IS NO 
GUARANTEE THAT A READ OR WRITE FOR ANOTHER SEGMENT ON THAT TRACK 
MIGHT NOT BE CONFUSED BY NOISE IN THE BAD SECTOR (E.G., NOISE 
MIGHT LOOK LIKE AN ADDRESS MARK). 


DO311. MCP - PARTNER ATTRIBUTE - 05-07-73 PpeE Nee 


DO311 MCP - PARTNER ATTRIBUTE - 05-07-73 


IF A TASK DOES NOT HAVE A PARTNER THEN THE TASK ITSELF IS RETURNED 
AS A PARTNER. 


D0320 MCP - MPX LOAD LEVEL INPUT MESSAGE - 06-03-73 


THE KEYBOARD COMMAND LL 1S NOW AVAILABLE FOR INTERROGATION, AND 
SETTING THE MODEL II MULTIPLEXOR LOAD LEVEL FUNCTION. THE SYNTAX 
IS AS FOLLOWS: 


‘LL MCP <N>, ...<ETX> 


THIS SETS THE LOAD LEVEL OF MPX <N> TO <L>. THE SAME KIND OF LIST 
IS ALLOWED AS FOR SN: 


LL <ETX> 
WILL DISPLAY THE LOAD LEVELS FOR ALL PRESENT MULTIPLEXORS. 


posed; “MCE 2 PESsa Tacs eee 7 06-03-73 

THIS PATCH PROTECTS THE SYSTEM FROM HAVING AN IN-USE DISK PACK 
TURNED OFF. IF AN IN-USE DISK PACK (ONE WITH OPEN FILES ON IT) IS 
TURNED OFF, THE SYSTEM WILL DEMAND THAT IT BE TURNED ON WITH THE 
SAME PACK MOUNTED. THE PREVIOUS LACK OF THIS REQUIREMENT COULD 
CAUSE SYSTEM FAILURE. 


THIS CHANGE IMPLEMENTS VOLUME PROTECTION BY OWNERS NAME. PLEASE 
REFER TO CONTROLLER DO399 FOR FURTHER INFORMATION. 


THIS CHANGE ALSO CORRECTS SEVERAL PROBLEMS IN LIBRARY MAINTENANCE 
FOR DISK PACKS. 


PAGE 130 
DO32@2.=« MCP) «= _LOGGING-INCLUDE UNIT NUMBER - 06-03-73' °° : 


BUSES MCE. -2) ROSCINGTINCLUDE UN PI NUMBER ir OS 0S=73 

A NEW FIELD IS ADDED TO WORD SEVEN OF LOG OPEN AND CLOSE RECORDS. 
THIS IS THE UNIT NUMBER FIELD, [39:8]. THIS FIELD IS NOT VALID FOR 
HEAD-PER-TRACK DISK OR REMOTE FILES. 


Doses MCE se EOD EOC ING <2 0Ss03ei5 

THIS PATCH CAUSES THE VALUE FOR ACTIVETIME (ZERO IF THE ACTIVETIME 
OPTION IS RESET) TO BE PLACED IN WORD 20 OF THE EOJ LOG RECORD. 
VARIABLE INFORMATION NOW STARTS IN WORD 21. IN ADDITION, LOGGING 
PROBLEMS WHICH COULD RESULT IN A DEADLOCK IN NOUSERDISK SITUATIONS 
AND DIFFERENT TIME VALUES IN THE LOG AND THE TASK HAVE BEEN 
CORRECTED, 


pees (OEE. OEE EIR el CueNee. 2 28212273 

IF A FILE NAMED A/B IS CHANGED TO A FILE C/D AND GETS A "DUP FILE" 
MESSAGE (FOR EXAMPLE, IF AUTORM IS RESET OR C/D IS A DIRECTORY), 
THEN A HALT-LOAD WILL REMOVE A/B FROM THE DIRECTORY AND C/D WILL BE 
UNCHANGED . 


DO329 MCP - USER PROGRAM SAVE CORE - O6-19-73 


A PROGRAM WHICH LOOPS GETTING SAVE CORE (E.G. DIRECT ARRAYS) CAN 
HANG THE SYSTEM BY EXHAUSTING ALL CORE. 
DO330 MCP - ALGOL TIME (14) - 06-19-73 


THE TIME (14) FUNCTION DOES NOT RETURN THE TIME SINCE HALT-LOAD BUT 
RATHER THE CONTENTS OF THE SIX-BIT MACHINE CLOCK IN MULTIPLES OF 


D0330 MCP - ALGOL TIME (14) - 06-19-73 Pace: 


2.4 MICROSECONDS. IT BEARS THE SAME RELATION TO TIME (4) THAT TIME 
(11) DOES TO TIME (1). 


DO348 MCP - LOG COMPARE ERRORS IN LIBMAINT -—- O06-e4-73 


LIBRARY MAINTENANCE COMPARE ERRORS WILL BE LOGGED IF THE. COMPILE- 
TIME DIAGNOSTICS OPTION IS SET. 


LOG FORMAT FOR COPY ERRORS: 
LOG MAJOR TYPE =e 


LOG MINOR TYPE = 11 "MLLIBERR" 
WORDS 0 - 3 AS USUAL 
WORD 4 — SOURCE INFORMATION WORD 


[4O:1] TAPE FLAG (1=> TAPE) 

[39:8] UNIT NUMBER 

[31:12] FIRST WORD IN SOURCE ON WHICH 
COMPARE FAILED 

[19:20] ADDRESS IF DISK 


WORD 5 CONTENTS OF FIRST SOURCE WORD ON WHICH 
COMPARE FAILED | 

WORD 6 DESTINATION INFORMATION WORD (SAME 
AS WORD FOUR) 7 

WORD 7 CONTENTS OF FIRST DESTINATION WORD ON 


COMPARE FAILED 
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DUE TO HARDWARE PROBLEMS, BACKSPACING A B5500 LIBRARY MAINTENANCE 
TAPE TO BEGINNING OF FILE IS NOT ALWAYS SUCCESSFUL ON THE B6700. 
THE TAPE MAY BE BACKSPACED THROUGH AN INDETERMINATE NUMBER OF FILES. 


THE B6700 LIBRARY MAINTENANCE ROUTINE DEPENDS ON BACKSPACING IN THE 
COMPARE PHASE OF LIBRARY MAINTENANCE COPY. DURING THE COMPARE 
PHASE, THE ROUTINE BACKSPACES TO. BEGINNING OF FILE TO REREAD THE 
FILE DISK DIRECTORY HEADER. IF THE BACKSPACE IS UNSUCCESSFUL, AN 
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INCORRECT HEADER IS READ. MINIMAL CHECKING FOR THIS CONDIDTION IS 
DONE . IF THE FILE LABEL IS READ, A TAPE POSITIONING ERROR MESSAGE 
1S OUTPUT AND LIBRARY MAINTENANCE IS TERMINATED. 


USERS EXPERIENCING THIS PROBLEM SHOULD USE SIMPLE COPY TO INPUT 
B5500 LIBRARY MAINTENANCE TAPES. 


D0384 MCP - FASTER LIST DIRECTORY - 06-24-73 


THIS CHANGE IMPLEMENTS A NEW VERSION OF LIST/DIRECTORY WHICH 
PRODUCES A DIRECTORY ANALYSIS COMPARABLE TO THE OUTPUT OF SYSTEM/ 
LISTDIRECTORY. A SIGNIFICANT SPEED INCREASE WILL BE OBSERVED WHEN 
PROCESSING LARGE NUMBERS OF FILES. 


THE NEW PROGRAM USES A_ GETSTATUS DIRECTORY COPY CALL WHICH IS 
INVOKED WITH A MAJOR TYPE OF THREE AND A MINOR TYPE OF THREE. 


A LOGICALLY LINKED DIRECTORY COPY IS PRODUCED, ASSUMING A 
MAXRECSIZE AND BLOCKSIZE OF 30 WORDS. 


THE FILE 1S STRUCTURED SUCH THAT THE FIRST 90 WORD DIRECTORY. NAME 
BLOCK PHYSICALLY FOLLOWS EACH DIRECTORY HEADER. ADDITIONAL NAME 
BLOCKS ARE POINTED TO BY WORD ONE (PREDECESSOR LINK). .A ZERO VALUE 
INDICATES END OF CHAIN). THE FILE HEADER AND FIRST NAME BLOCK OF 
SYSTEM DIRECTORY ARE LOCATED IN LOGICAL ADDRESSES O-3 OF THE FILE. 


LOWER LEVEL DIRECTORY HEADERS AND FILE HEADERS ARE LINKED VIA WORD 
ZERO OF A FILE NAME ENTRY. FORMAT OF WORD ZERO IS: 


LOGICAL LINK = [47:20] 
FILE KIND = [27:8] 
HEADER SIZE = [19:16] 


GETSTATUS MUST ALSO BE PASSED A FILE NAME FOR THE COPY FILE. THE 
NAME MUST BE IN MCP STANDARD FORM. 


IF SECURED FILES ARE PRESENT THE CALLING PROGRAM MUST BE RUNNING 
UNDER A PRIVILEGED USER CODE. THE CALLING PROGRAM DOES NOT HAVE TO 
BE RUN UNDER A PRIVILIGED USER CODE IF NO SECURED FILES ARE PRESENT. 
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D0385 MCP - TASK AND QUEUE PRIORITY LIMIT —- 07-08-73 


THE PRIORITY OF A SUBTASK IS NOT ALLOWED TO EXCEED THE JOB QUEUE 
PRIORITY LIMIT. 


D0387 MCP - REDUCE SAVE CORE - 07-08-73 

THIS CHANGE IMPLEMENTS A "NODUMP" COMPILE TIME OPTION WHICH WILL, 
WHEN SET, REDUCE SEGMENTS OF SAVE CORE BY APPROXIMATELY 650 WORDS. 
WITH “NODUMP" SET NO MEMORY DUMPS WILL BE TAKEN. NON-FATAL HANGS 
CALLING MEMDUMP CAUSE A MESSAGE TO BE DISPLAYED (IDENTICAL TO 
NODUMP RUN TIME OPTION MESSAGES). FATAL DUMPS CAUSE THE SYSTEM TO 
DO A DEFUNCT OF "FATAL DUMP HALT/LOAD" REQUIRING A MANUAL HALT/LOAD. 
THE OPTION IS RELEASED RESET. 


DO388 MCP =— NEW SUBTYPES — SET-—GET ‘STATUS = 07-14-73 


THIS PATCH ADDS THREE CASES TO SETSTATUS UNITS PORTION. THESE ARE 
AS FOLLOWS: 


1. SUBTYPE #8 —- WHICH ALLOWS CHANGING THE MODE OF A GIVEN 
UNIT: E.G., TO MAKE IT WRITE ENABLED. A <UNIT NUMBER 
LIST> 1S REQUIRED ON’ THE SETSTATUS CALL. THIS CASE IS 
ONLY APPLICABLE TO DISK PACKS AND MAGNETIC TAPE UNITS. 
THE UNIT MAY NOT BE ASSIGNED OR RESERVED AT THE TIME OF 


THIS CALL. THE UNITS WRITE RING STATUS IS SET TO ONE IF 
"V" TS GREATER THAN ONE OR ELSE IT IS SET TO ZERO. THE 
"MODE" (I.E., “V") IS RETAINED ACROSS A HALT/LOAD. 

2. SUBTYPE #11 - ALLOWS A DISK -PACK TO BE LABELED. A 


SETSTATUS <UNIT NUMBER LIST> IS REQUIRED. A STRING LIST 
IS REQUIRED THAT MATCHES THAT OF A SETSTATUS UNIT REQUEST 
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TYPE TWO, V EQUALING ONE OR TWO. WHEN THIS CALL IS 
PERFORMED. A VISIBLE INDEPENDENT RUNNER TITLED "LB PK 
<NUMBER>" WILL BE STARTED. 


3. SUBTYPE #12 - THIS CASE ALLOWS "ASSOCIATING" A SERIES OF 
<DESTINATION UNITS> WITH A <SOURCE LIST>. THE SETSTATUS 
ARRAY FORMAT IS AS FOLLOWS: 


afo] Af1] Af2] Af3] AT 4] A[5] A[ 6] AL7] Al 8] A[9] 


| an pm] es fom fos forte | 


<Source list> <Destination list> 


# of items in 
“Destination list>+1 


# of items in 
<Source list>+1 


THE <SOURCE LIST> AND <DESTINATION LIST> ARE A <UNIT 
NUMBER LIST>. 


IF V EQUALS ZERO THEN THE DESTINATION LIST IS NOT USED, 
AND ALL "PERIPHERAL ASSOCIATIONS" ASSOCIATED WITH THE 
<SOURCE LIST> ARE DISASSOCIATED FROM THE UNITS OF THE 
<SOURCE LIST>. 


IF V EQUALS ONE THE ASSOCIATION ATTACHED TO THE FIRST UNIT 
OF THE <SOURCE LIST> BECOMES THE <DESTINATION LISTD> USED 
BY ALL OTHER MEMBERS OF THE <SOURCE LIST>. THIS 
<DESTINATION LIST> MAY BE AMMENDED BY INFORMATION FROM THE 
SETSTATUS ARRAY "A" <DESTINATION LIST>. THIS IS 
ACCOMPLISHED THROUGH THE USE OF THE "ERRORVALUEF" OF EACH 
ITEM IN THE <DESTINATION LIST>. IF THE ERROR FIELD EQUALS 
a ZERO THE UNIT IS DELETED FROM THE ORIGINAL ASSOCIATION 
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OTHERWISE IF IT EQUALS ONE IT IS ADDED TO THE ORIGINAL 
ASSOCIATION LIST. THE <DESTINATION LIST> MAY BE <EMPTY>. 


IF V EQUALS THO, THE <DESTINATION LIST> BECOMES. THE NEW 
ASSOCIATION FOR ALL UNIT OF THE SOURCE LIST>. . WITH THIS 
TYPE OF CALL, THE <DESTINATION LIST> MAY NOT BE EMPTY AND 
ALL ITEMS OF THE <DESTINATION LIST> ARE UNCONDITIONALLY 
ADDED TO THE ASSOCIATION. 


THE "ASSOCIATIONS" ARE MAINTAINED OVER A HALT/LOAD VIA 
LOGIC ADDED TO THE CONTROLLER. . 


THIS PATCH ALSO ADDS A NEW SUBTYPE FOR SPECIFYING AND INTERROGATING 
THE DATA MANAGEMENT MONITOR TITLE (DM MESSAGE) TO THE MISCELLANEOUS 
REQUESTS: 


SUBTYPE #24 - TO CHANGE DM MONITOR NAME. THE EXTENSION © 
LENGTH IS ZERO. IF THE VALUE IS EQUAL TO ZERO THE DEFAULT DM 
MONITOR NAME IS TO BE SET TO SYSTEM/DM6700. IF THE VALUE IS 
EQUAL TO ONE THE DM MONITOR NAME MUST BE SET. IN THAT CASE, 
ARRAYROW CONTAINS POINTER TO STANDARD FORM NAME. 


TWO NEW ERROR MESSAGES HAVE BEEN ADDED TO SETSTATUS AS FOLLOWS: 


1. ERROR MESSAGE #92 -— PRODUCES THE FOLLOWING MESSAGE: "A 
REQUIRED LOCK IS IN USE" 


2. ERROR MESSAGE #93 - INDICATES A REQUEST WAS MADE AGAINST A 
GROUP (FROM SOURCE LIST, V=0,1) AND THE <SOURCE ITEM> DID 
NOT HAVE A PERIPHERIAL ASSOCIATION. 


IIs GETSTATUS 


TWO NEW BITS HAVE BEEN ADDED TO THE’ GETSTATUS UNIT REQUEST SECTION. 

THESE ARE MASK BITS #25 AND #26. MASK BIT #25 RETURNS ALL UNITS 
ASSOCIATED WITH A DESIGNATED UNIT. “LINKF"™ FOR MASK BIT #25 POINTS 
TO THE FOLLOWING: 


WORD O NUMBER OF ENTRIES FOLLOWING THIS WORD (IN WORDS). 
WORD 1-N ONE WORD FOR’ EACH UNIT IN THIS ASSOCIATION. © THE 
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WORD CONTAINS THE UNIT NUMBER IN “UNITNUMF" AND THE 
UNIT TYPE IN UTYPEF. . 


MASK BIT #26 RETURNS THE NUMBER OF UNITS ASSOCIATED WITH THE 
REQUESTED UNIT. 


A NEW SUBCLASS IS ALSO ALLOWED FOR PERPHERIAL ASSOCIATIONS. 
SUBTYPE ONE WILL ALLOW THE USE OF SUBCLASS = Z. UNDER THIS REQUEST 
ALL UNITS THAT HAVE A PERIPHERIAL ASSOCIATION WILL BE RETURNED BY 
GETSTATUS. MASK BIT #25 AND #26 MAY ALSO BE USED W1TH THIS REQUEST. 


ANOTHER BIT TO THE MISCELLANEOUS REQUEST SECTION, SUBTYPE ONE, HAS 
ALSO BEEN ADDED TO RETRIEVE THE NAME OF THE DM MONITOR. MASK 
PARAMETER BIT 23 TRUE MEANS TO GET THE CURRENT DM MONITOR TITLE. 
THE REPLY TYPE IS STANDARD FORM INDEX TO A DM MONITOR TITLE OR AN 
INDICATION THAT NONE HAS BEEN SPECIFIED (THE VALIDITY BIT IS 
RETURNED FALSE) OR AN ERROR MESSAGE VALUE #92 MEANING "A REQUIRED 
LOCK IS IN USE". 


DO389 MCP - REDUCE EXECUTION STACK SIZE - 07-14-73 

THIS IMPLEMENTATION ‘REDUCES THE AMOUNT OF STACK OVERHEAD PROVIDED 
BY THE SYSTEM FOR EXECUTION STACKS BY 200 WORDS IF THE DIAGNOSTIC 
OPTION IS RESET AND 130 WORDS IF THE DIAGNOSTIC OPTION [S SET. 
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ry INTRODUCTION 
ie TEST PARAMETERS AND ERROR REPORTING 
Ill. TEST SEQUENCES 


PARAGRAPH OPERATOR 
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IV. RESOURCES USED 
I. INTRODUCTION 


THE PROCESSOR CONF IDENCE 


PAGE 

OPERATOR 

BRTR, BRFL, BRUN 

SAME, DUPL 

LTS, LTi6 

ADDRESS ADDER, LODT 

‘SPLT, JOIN 

SPRR, RPRR 

LOR 

LNOT 

EXCH 


STAG, RTAG, SAME 
C.[13:61+Z10.15:6] FOR NAMC 
DIS STEERING . 
Z651 MASKING 

ADDER CARRY AND BORROW 

RUP . 


-SAME, DUPL 


LOR 
LNOT 


~ EXCH 


NTGR 

CLSD, CEQD, CGTD 
CEQD, CNED . 
SEQU 

SCNI 
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TESTS ESTABLISH A_ BASIC LEVEL OF 


CONFIDENCE IN THE CORRECT OPERATION OF PROCESSOR REGISTERS AND | 


INTER-REGISTER BUSES. 


FLOW-OF-CONTROL (J-COUNT) 


ARE NOT EXPLICIT TESTS OF HARDWARE 
LOGIC OR OF SPECIAL DECODERS OR DATA-— 


TRANSFER PATHS WHICH ARE USED ONLY BY CERTAIN SPECIFIC J-COUNTS OF 


SOME OPERATORS. 
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THE ORDER OF THE TESTS IS DETERMINED BY THE FUNCTION PERFORMED BY 
THE OPERATOR-UNDER-TEST AND THE RESTRICTION THAT A FUNCTION BE 
SUBJECTED TO A TEST BEFORE IT IS USED IN THE CHECKING OF SOME OTHER 
FUNCTION, WHEREVER SUCH PREVIOUS TESTING 1S FEASIBLE. 


WE ASSUME THAT THE TEST SEQUENCE MAY BE EXECUTED BY ANY ON-LINE 
PROCESSOR, THAT A REQUEST FOR EXECUTION OF THE TESTS MAY SPECIFY 
WHICH PROCESSOR(S) SHOULD BE USED, AND THAT NO TEST SEQUENCE LOSES 
CONTROL OF ITS PROCESSOR (1.E., THE ENTIRE SEQUENCE IS EXECUTED 
WITH EXTERNAL INTERRUPTS DISABLED). . 


AN ON-LINE VERSION OF THESE TESTS WILL BE INCORPORATED IN THE MCP; 
IT WILL BE ACTIVATED FOR EACH ON-LINE PROCESSOR WHEN THERE IS NO 
OTHER .USEFUL WORK FOR THE PROCESSOR TO DO (1.E., THE PROCESSOR 
WOULD BE DISPLAYING THE "B" IN ITS REGISTERS) AND A REASONABLE 
PERIOD OF TIME HAS PASSED SINCE THIS PROCESSOR WAS LAST TESTED AND 
KEYBOARD OPTION 15 ("TESTCPU") IS SET. THE "REASONABLE PERIOD OF 
TIME" IS SET TO ONE HOUR AT HALT/LOAD, BUT WILL BE DECREASED TO ONE 
HALF OF ITS PREVIOUS VALUE FOR EACH EXECUTION WHICH DISCOVERS AN 
ERROR. 


AN OFF-LINE STAND-ALONE VERSION WILL ALSO BE AVAILABLE. THIS 
VERSION WILL CONSIST OF A’ SKELETON MCP TO HANDLE INTERRUPTS, 
INITIATE THE PROCESSORS EXECUTION OF THE TESTS, ETC., AND A SET OF 
SINCLUDE CARDS WHICH CAUSE THE TESTS THEMSELVES TO BE COMPILED FROM 
THE APPROPRIATED SECTIONS OF THE MCP SYMBOLIC. 


Il. TEST PARAMETERS AND ERROR REPORTING 


THE DATA USED IN ALL OF THE REGISTER AND BUS VERIFICATION TESTS 
CONSISTS EITHER OF LITERAL VALUES RESULTING FROM SOME FORM OF 
LITERAL CALL OPERATOR (£.G., LTI, LT4Y8) OR OF A KNOWN DATA PATTERN 
RETRIEVED FROM A READ-ONLY ARRAY. THE RESULT OF APPLYING THE 
OPERATOR-UNDER-TEST TO THIS KNOWN DATA IS "FLOATED" ON THE TOP OF 
THE STACK, AND THE VERIFICATION TESTS ARE PERFORMED ON A COPY OF 
THIS TEST RESULT CREATED BY MEANS OF A DUPL OPERATOR. THUS, IF THE 
OPERATOR-UNDER-TEST HAS PRODUCED AN INCORRECT RESULT, THIS RESULT 
IS "FLOATING" ON TOP OF THE STACK, AND THE OPERATOR SEQUENCE AND 
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TEST DATA MAY BE DETERMINED FROM THE COMBINATION OF SDI, PIR, PSR 
AND A PROGRAM LISTING. 


THE ON-LINE VERSION OF THESE TESTS WILL ATTEMPT TO ENTER THE 
EVIDENCE OF FAILURE IN THE SYSTEM SUMLOG FOR SUBSEQUENT FORMATTING 
AND PRINTOUT BY THE SYSTEM/LOGANALYZER PROGRAM. 


THE OFF-LINE VERSION WILL HALT WHEN AN ERROR IS DETECTED. THE TEST 
SEQUENCE MAY BE DETERMINED BY MANUALLY READING SDI, PIR, SPR AND S 
VIA THE MDL DISPLAY AND EXAMINING THE TOP-OF-STACK OPERAND VIA THE 
MEMORY TESTER TO DETERMINE THE INCORRECT RESULT RETURNED BY THE 
SUSPECTED FAILING OPERATOR. THE PROGRAM CODE MAY THEN BE. 
DETERMINED EITHER BY FINDING THE CODE IN MEMORY VIA THE MEMORY 
TESTER OR BY REFERRING TO A PROGRAM LISTING. 


ll. TEST SEQUENCES 
A DESCRIPTION OF THE HARDWARE FUNCTION UNDER TEST, THE TEST 
PARAMETERS AND THE EXPECTED (CORRECT) RESULT IS PROVIDED IN THE 
FOLLOWING PARAGRAPHS. 


THE ASSOCIATION OF A TEST NUMBER WITH A’ GIVEN REGISTER-BUS 
COMBINATION IS A TWO-STEP PROCESS: 


1. FIRST DETERMINE THE OPERATOR BY LOCATING THE DESIRED 
TRANSFER FUNCTION IN THE HEADING OF TABLE ONE. A “1" 
INDICATES THAT THE DESIGNATED OPERATOR USES THIS REGISTER- - 
BUS COMBINATION FOR’ SINGLE-PRECISION OPERANDS AND A "“e" 
INDICATES THAT THIS OPERATOR ALSO VERIFIES THIS PATH FOR 
DOUBLE-PRECISION TEST ARGUMENTS. AN "*" INDICATES THOSE 
FUNCTIONS WHICH ARE USED BY THE DESIGNATED OPERATOR BUT 
ARE NOT EXPLICITLY CHECKED BY THE CORRESPONDING OPERATOR 
TEST. 


2. HAVING DETERMINED THE TEST OPERATOR, TABLE TWO IDENTIFIES 
THE TEST NUMBER WHICH USES THIS OPERATOR. 


FOR EXAMPLE, BTZ6 IS USED BY BOTH THE DUPL AND RSUP 
OPERATORS (TABLE ONE). THE VERIFICATION TEST FOR DUPL IS 
TEST THREE FOR SINGLE-PRECISION OPERANDS AND TEST 17 FOR 
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DOUBLE-PRECISION OPERANDS; THE RSUP VERIFICATION IS 
PERFORMED BY TEST 16 (TABLE TWO). 
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3.1. HARDWARE FUNCTIONS: Z3TP, PTZ4, PARITY-CHECK CIRCUITRY ON 
Z4 BUS 
OPERATOR: LT48 


TEST ONE IS INTENDED TO CHECK FOR SINGLE DROPPED AND PICKED 
UP BITS IN PERFORMING THE LT48 OPERATOR. 


THE FIRST TEST SEQUENCE CONSISTS OF EXECUTING LT48 OPERATORS 
WITH NUMERIC ARGUMENTS CONSISTING OF A WORD OF ZEROES WITH A 
SINGLE ONE-BIT IN EACH OF THE 48 DATA-BIT POSITIONS. 


~ THE SECOND SEQUENCE PERFORMS LT48S OF VALUES CONSISTING OF A 
WORD OF ALL ONES WITH A SINGLE ZERO IN BIT POSTIONS ZERO 
THROUGH 47. 


THE RESULTS OF THESE LT4Y8 OPERATORS ARE LEFT "FLOATING" ON 
THE TOP-OF-STACK UNTIL TEST 15 IS COMPLETED. AT THAT TIME, 
THE VALUES INITIALLY LOADED INTO THE STACK ARE CREATED USING 
OPERATORS ZERO, DBST AND LNOT AND COMPARED WITH THE TEST1 
VALUES. AN UNEQUAL COMPARISON COULD BE DUE EITHER TO AN 
INCORRECT RESULT FROM THE ORIGINAL LT48 OR (MORE LIKELY) 
FROM A FAILURE IN THE DBST OR -LNOT OPERATORS. 


"AN ERROR IN THE FIRST PART OF TEST! CAUSED BY THE ALTERATION 
OF THE VALUE LOADED BY THE LT48 RESULT MAY CAUSE A PROCESSOR 
MEMORY PARITY ERROR. 


3.2. HARDWARE FUNCTION: - CTZ6, DIS SHIFTOR LOGIC, Z10C, AROO- 
, AROO1 SENSING 
OPERATORS: BRTR, BRUN, BRFL 


THE INDICATION OF UNSUCCESSFUL OPERATION OF SUBSEQUENT TESTS 
WILL TYPICALLY INVOLVE A CONDITIONAL -BRANCH AROUND THE — 
ERROR-REPORTING CODE. THE PURPOSE OF THIS TEST IS TO. 
ESTABLISH A MINIMAL LEVEL OF CONFIDENCE IN THE ABILITY TO 
PERFORM THE BRTR, BRUN AND BRFL FUNCTIONS. . 


THE TEST ALGORITHM CONSISTS OF EXECUTING A SEQUENCE OF 
TOPOFSTACK := TRUE, TOPOFSTACK := FALSE, IF BOOLEAN 
(TOPOFSTACK) THEN GO TO, AND IF NOT BOOLEAN (TOPOFSTACK) 
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THEN GO TO STATEMENTS WHICH ARE DIFFICULT TO DESCRIBE IN 
PROSE; THE COMBINATION OF VALUES PLACED IN THE STACK AND 
CONDITIONAL BRANCHES EXECUTED WILL RESULT IN A CALL ON THE 
ERROR-LOGGING PROCEDURE FOR EACH TEST WHICH DOES NOT PERFORM 
THE CORRECT BRANCH OPERATIONS. THE “MAZE" OF CONDITIONAL 
BRANCHES IS CONSTRUCTED SUCH THAT IT IS NOT POSSIBLE TO 
TRAVERSE THE MAZE WITHOUT MISHAP UNLESS ALL ‘BRANCHES ARE 
EXECUTED CORRECTLY. ; 


3.3. HARDWARE FUNCTIONS: = LOTJ, LOTJU LITK (=SAME), WBML, WSML, 
| BUO3; (Z6T1) : 
OPERATORS: DAME, DUPL 


SUBSEQUENT TEST ALGORITHMS WILL TYPICALLY PLACE ONE OR MORE 
TEST OPERANDS IN THE STACK, PERFORM THE TEST ALGORITHM, 
DUPLICATE THE RESULT OF THE TEST AND CHECK THIS DUPLICATE 
FOR CORRECTNESS. 


THE DUPLICATION IS NECESSARY IN ORDEF ~2 PRESERVE THE ACTUAL 
RESULT OF THE TEST SO THAT IMMEDIATE DIAGNOSIS OR LOGGING 
CAN BE PERFORMED IF THE RESULT IS INCORRECT. 


THE "CHECK FOR CORRECTNESS" WILL USUALLY CONSIST OF PLACING 
THE EXPECTED CORRECT RESULT IN THE STACK AND EXECUTING A 
SAME OPERATOR FOLLOWED BY A BRTR OR BRFL AROUND THE ERROR- 
REPORTING CODE. 


AT THIS EARLY STAGE OF THE TEST SEQUENCE, THERE IS NO KNOWN 
RELIABLE METHOD OF COMPARING TWO OPERAND VALUES WHICH 
CONTAIN NON-ZERO BITS IN THE MOST SIGNIFICANT NINE BITS OF 
AN OPERAND VALUE ((47:91]). THE PURPOSE OF TEST THREE IS TO 
ESTABLISH CONFIDENCE OR DETECT ERRORS IN THE OPERATION OF 
THIS DUPL/SAME CHECKING CODE. 


THE FIRST SEQUENCE OF TESTS LOADS TWO VALUES CONSISTING OF 
ZEROES WITH A SINGLE ONE BIT IN BIT POSITONS I AND J FOR O 
LEQ I, J LEQ 47, EXECUTING SAME, DUPL AND PERFORMING THE 
APPROPRIATE BRTR OR’ BRFL AROUND THE ERROR-REPORTING CODE, 
DEPENDING UPON WHETHER I = J OR I # J. 


3 


or 
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THE SECOND TEST SEQUENCE PERFORMS THE SAME FUNCTIONS ON 
VALUES CONSISTING OF WORDS OF ALL-ONES WITH SINGLE ZERO BITS 
IN BIT POSITIONS I AND J. . 


HARDWARE FUNCTIONS: OPERATOR SYLLABLE SELECTION FROM ALL 
_ SIX POSITIONS OF P-REGISTER, Z10C DATA 
TRANSFER FROM ALL P-REGISTER 
POSITIONS, PROF SYNCHRONIZATION FOR 
MULTI-SYLLABLE OPERATORS 
OPERATORS: LT8, LT16 


THE Z10 BUS IS AN EIGHT-BIT-WIDE PATH BETWEEN THE PSR- 
SELECTED SYLLABLE IN THE P REGISTER AND THE LEAST 
SIGNIFICANT EIGHT BITS IN THE C-REGISTER. IT IS USED BY 
MULTI-SYLLABLE OPERATORS (E.G., VALC, NAME, LT8, LT16) TO 
ACQUIRE THE SECOND THROUGH NTH OPERATOR SYLLABLES. 


THE PURPOSE OF TEST FOUR IS TO VERIFY THAT AN OPERATOR CAN 
BE SELECTED FROM ANY SYLLABLE OF THE P-REGISTER AND THAT 
MULTI-SYLLABLE OPERATORS ARE ABLE TO OBTAIN OPERATOR 
SYLLABLES TWO THROUGH N BY MEANS OF THIS Z10C DATA PATH. 


THE TEST CONSISTS OF EIGHT DATA-DEPENDENT SECTIONS. FOR 
EACH OF THESE SECTIONS, THE CODE CONSISTS OF EIGHT PAIRS OF 
LT8 <NUMBERI>, LT16 <NUMBER@><NUMBER3> OPERATORS FOLLOWED BY 
16 COMPARISONS OF THE CURRENT TOP-OF-STACK VALUE WITH THE 
CORRECT RESULT GENERATED BY MEANS OF A LT48 OPERATOR. 


THE EIGHT SECTIONS USE NUMERIC VALUES CONSISTING OF 

CONCATENATED EIGHT-BIT BYTES CONTAINING CYCLICALLY SHIFTED 
GROUPS OF ONE TO EIGHT ADJACENT ONE-BITS; EACH SUCH EIGHT- 
BIT VALUE IS UNIQUE (NO TWO OPERATORS GENERATE THE SAME 
NUMERIC VALUE), AND EACH OF THE VALUES OCCURS AS THE 
ARGUMENT FOR A LTS AND IN BOTH ARGUMENT POSITIONS FOR LT16. 


THE OPERATORS ARE EXECUTED AS LT8-LT16 PAIRS SO THAT EACH 
SYLLABLE POSITION OF BOTH THE LT8 AND LT16 OPERATOR OCCURS 
IN ALL OF THE SIX POSSIBLE POSITIONS OF THE P-REGISTER IN 
EACH OF THE EIGHT TEST SECTIONS. 
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THE FIVE-SYLLABLE LENGTH OF THE LT8-LT16 TEST SEQUENCE IS 
NOT A SUBMULTIBLE OF THE SIX-SYLLABLE LENGTH OF THE P- 
REGISTER, SO THAAT EACH TEST SECTION CONTAINS LT8/LT16 
OPERATORS WHICH BEGIN IN EACH OF THE SIX POSSIBLE P-REGISTER 
POSITIONS; EACH SECTION ALSO CONTAINS LT8 AND LT16 OPERATORS 
WHICH ARE SPLIT ACROSS A WORD BOUNDARY. 


3.5. HARDWARE FUNCTIONS: ADDRESS ADDER, MEMORY ADDRESSING 
OPERATORS: INDX, LODT 


SUBSEQUENT TESTS WILL USE NXLV OR INDX-LODT OPERATORS TO 
REFERENCE TEST INPUT DATA AND EXPECTED RESULTS. 


TEST TWO PERFORMS A PRELIMINARY CHECK ON -THESE SEQUENCES FOR 

REFERENCING ARRAY DATA BY LOADING THE WORDS AT INDEX VALUES 
e2**IT-1 AND e**I] FROM THE READ-ONLY ARRAY OF TEST PARAMETERS, 

FOR 1 LEQ I LEQ 8. THESE INDEX VALUES ARE CHOSEN TO PRODUCE 
THE MAXIMUM-LENGTH AND MINIMUM-LENGTH CARRIES IN THE ADDRESS - 
ADDER WHEN THE LODT OPERATOR IS EXECUTED. 


THE VALUES THUS RETRIEVED FROM THE READ-ONLY ARRAY ARE 
COMPARED WITH CORRECT VALUES GENERATED BY MEANS OF LT48 


OPERATORS. AN UNEQUAL (NON-SAME) COMPARISON CONSTITUTES AN 
ERROR. — 
3.6. HARDWARE FUNCTION: 2475 


OPERATORS: SPLT, JOIN 


THE PRIMARY PURPOSE SERVED BY TEST SIX IS TO VERIFY THE 
CORRECT OPERATION OF THE Z4T3 DATA TRANSFER PATH, WHICH IS 
USED FOR PUSH-DOWN AND POP-UP OPERATIONS BY THE STACK 
CONTROLLER. 


THE ALGORITHM CONSISTS OF PLACING A WORD OF ALL-ONES IN THE 
B-REGISTER, A WORD OF ZEROES IN THE A-REGISTER AND EXECUTING 
A SEQUENCE OF JOIN, SPLT PAIRS OF OPERATORS. FOLLOWING THE 
LAST SPLT, DUPLICATES OF THE TWO TOP-OF-STACK OPERANDS ARE 
CHECKED FOR EQUALITY WITH THE ORIGINAL VALUES, USING THE 
SAME OPERATOR. 


uy 
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THE PUSH-DOWN AND POP-UP OPERATION WHICH IS IMPLICITLY 
TESTED BY THIS SEQUENCE WILL BE USED IN SAVING AND RESTORING 
THE CONTENTS OF SOME PROCESSOR IC REGISTERS IN TEST SEVEN. 


3.7. HARDWARE FUNCTIONS: ABILITY TO SET AND READ MOST 
ADDRESSABLE IC REGISTERS 
OPERATORS: SPRR, RPRR : 


TEST SEVEN INITIALIZES ALL IC REGISTERS EXCEPT S, PIR, PBR 
AND F TO THE VALUE OF THE REGISTER-NUMBER; EACH OF THESE 
REGISTERS IS THEN SET TO ALL-ONES AND THE VALUE IS READ BACK - 
AND CHECKED FOR EQUALITY. THE TEST IS THEN REPEATED WITH AN 
ALL-ZEROES VALUE. AN INCORRECT VALUE RETURNED BY THE RPRR 
INSTRUCTION COULD BE EITHER AN ALL-ONES VALUE WITH ONE OR 
MORE DROPPED BITS OR AN ALL-ZEROES VALUE WITH PICKED-UP BITS 
OR THE REGISTER NUMBER OF THE MISADDRESSED REGISTER IF 
REGISTER SELECTION IS FAILING. AT THE CONCLUSION OF EACH’ 
ALL-ONES/ALL-ZEROES TEST, THE REGISTER CONTENTS ARE 
RESTRORED TO THE IC REGISTER NUMBER BEFORE PROCEEDING TO 
TEST THE NEXT REGISTER. 


F, DO, D1, LOSR, BOSR, SNR AND PDR VALUES ARE "FLOATED" ON 
THE TOP-OF-STACK BEFORE INITIATING TEST SEVEN AND RESTORED © 
TO THEIR INITIAL VALUES ON SUCCESSFUL COMPLETION. 


PIR, PSR, S AND ALL-ONES VALUE FOR F CANNOT BE TESTED. 


3.8. HARDWARE FUNCTIONS: LOGICAL TRANSFER PATH (LiTJ) 
OPERATOR: LOR 


THE PRELIMINARY CHECKOUT OF THE SAME OPERATOR IN TEST THREE 
HAS ALREADY VERIFIED THE (LOTJ, LOTK) = LEQV AND (LOTJ, 
LITK) = LNOT LOGICAL TRANSFER FUNCTIONS. TES) -ETGHE 

VERIFIES THE REMAINING L1iTJ FUNCTION (LOR) BY OR-ING A WORD 
OF ZEROES WITH A SINGLE ONE-BIT IN EACH OF THE 48 DATA 
POSITIONS WITH A WORD OF ALL-ZEROES AND CHECKING THE RESULT 
USING THE PREVIOUSLY VERIFIED SAME OPERATOR. . 


3.9. HARDWARE FUNCTIONS: LOGICAL TRANSFER NETWORK (LOTJ, LITK) 
OPERATOR:  LNOT 
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THE LNOT FUNCTION WAS IMPLICITLY CHECKED BY ITS USE IN 
EXECUTING THE SAME OPERATORS IN TEST THREE; HOWEVER, THE 
DUTY CYCLE FOR THE REGISTER-TO-BUS AND BUS-TO-REGISTER 
CONNECTIONS IN TEST THREE WAS SOMEWHAT LESS THAN THE MAXIMIM 
RATE. THE PURPOSE OF TEST NINE IS TO EXERCISE THE LOGICAL 
TRANSFER NETWORK AND ITS INPUT AND OUTPUT STACK WITH A 
OPERAND CONSISTING OF ALTERNATE ZERO-ONE BITS, PERFORMING A 
SEQUENCE OF 24 LNOT OPERATORS ON THIS VALUE AND VERIFIYING 
THAT THE ORIGINAL VALUE WAS PRESERVED. 


THE OTHER PAIR OF Z4 TO Z3 TRANSFER FUNCTIONS, LOTK + LITJ = 
Z4HT3, WAS VERIFIED IN TEST SIX. 


HARDWARE FUNCTIONS: ZoTe, “Z6T1" 
OPERATOR: EXCH 


THE Z5STe DIRECT TRANSFER PATH IS CHECKED BY LOADING THE A- 
AND B-REGISTERS WITH VALUES OF ZERO AND ALL-ONES; A SEQUENCE 
OF 24% EXCH OPERATORS IS THEN APPLIED TO THESE OPERANDS AND 
THE) RESULTING TOP TWO STACK WORDS ARE COMPARED WITH THE 
ORIGINAL VALUES. 


THE "Z6T1"  ZERO-DISPLACEMENT PATH THROUGH THE STEERING 
MATRIX BETWEEN THE Z6 AND Z1 BUSES WAS PREVIOUSLY VERIFIED 
IN TEST THREE; IT IS ALSO USED HERE, BUT AT A HIGHER DUTY 
CYCLE, SINCE THE STACK-ADJUST WHICH WAS NECESSARY IN TEST 
THREE IS NOT NEEDED IN THIS TEST. 


HARDWARE FUNCTIONS: B.f50:3I-A, Te: 3]; CotersI-A. Co01s1, 
"Z6T1"; A.(50:3] = B.(S50:3)4B.(50:3)] 
STAG, RTAG, SAME 


THE FIRST SEQUENCE OF TESTS CONSITS OF LOADING A WORD OF . 
ZEROES INTO THE STACK, SETTING THE TAG TO VALUES SEVEN, SIX, 
FIVE, FOUR, THREE, TWO, ONE, ZERO, READING THE TAG AND 
CHECKING FOR THE CORRECT VALUE. AFTER THE FINAL STAG/RTAG 
USING A TAG OF ZERO, THE OPERAND BITS ARE CHECKED FOR 
EQUALITY WITH THE ORIGINAL ALL-ZEROES VALUE. THE TEST IS 
THEN REPEATED USING AN OPERAND OF 48 ONE-BITS. 
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UPON SUCCESSFUL COMPLETION OF THIS FIRST SEQUENCE, EACH 
VALUE OF ZERO & (1) TAG IS COMPARED WITH ZERO & (J) TAG FOR 
I AND J = SEVEN, SIX, FIVE, FOUR, THREE, TWO, ONE, ZERO 
USING THE SAME OPERATOR TO PERFORM THE COMPARISON. A TRUE 
RESULT FOR THE SAME OPERATOR SHOULD BE PRODUCED FOR THE 
SEVEN CASES FOR WHICH THE A- AND B-REGISTER TAGS ARE EQUAL 
(1 = J) AND SHOULD BE FALSE FOR’ THE REMAINING 42 
COMBINATIONS OF TAG VALUES. 


HARDWARE FUNCTIONS: C.013:61=210.15-6] 


CONTROLLER 


BY PROGRAM 


OPERATOR: NAMC 


THE ‘LOW ORDER SIX BITS OF THE FIRST SYLLABLE OF A NAMC 
OPERATOR ARE TRANSFERRED TO. C.[13:6] BY MEANS OF SPECIAL 
GATING ON THE Z10 BUS USED BY THE PROGRAM CONTROLLER. TEST 
12) CHECKS THIS GATING BY EXECUTING A SEQUENCE OF NAMC 
OPERATORS WHOSE LOWER SIX BITS OF THE MOST SIGNIFICANT 
OPERATOR BYTE CONTAIN AN INDIVIDUAL ONE BIT IN EACH 


POSITION; 


COUPLE OF ALL ONES WITH AN 


THE SAME TEST IS THEN PERFORMED USING AN ADDRESS 


PSOITION OF THE FIRST BYTE. 


INDIVIDUAL ZERO IN EACH BIT 


THE HEX AND EQUIVALENT BINARY REPRESENTATION FOR THESE NAMC 


OPERATORS IS: 
6000 = 01100000 00000000 
5000'= 01010000 00000000 
4800 = 01001000 00000000 
4400 = 01000100 00000000 
4e00 = 01000010 00000000 
4100 = 01000001 00000000 
4300 = 01000011 O0000000 
4700 = 01000111 oO0000000 
4FOO = 01001111 OO000000 
SFOO = 01011111 O0000000 
7FO0O = 01111111 00000000 
7EO0 = 00000000 


01111110 
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7D00 = 01111101 00000000 
7B00 = 01111011 00000000 
7700 = 01110111 00000000 
6FO0O0 = 01101111 00000000 


THE RESULTING INDIRECT REFERENCE WORDS ARE CHECKED BY 
EXECUTING AN APPROPRIATE LT16 FOLLOWED BY ONE, STAG, SAME 
AND A CONDITIONAL BRANCH AROUND THE ERROR-REPORTING CODE. 


HARDWARE FUNCTION: STEERING NETWORK BETWEEN Z6_ AND Z1 
BUSES 
OPERATOR:  INSR 


THE Z6T1 INTER-BUS DATA TRANSFER OPERATION REQUIRES 
SPECIFICATION OF BOTH THE AMOUNT OF DISPLACEMENT (DIS) AND 
THE DESTINATION BITS TO BE "PROTECTED" FORM MODIFICATION 
(TOA, TOM). TEST 13 CHECKS THE DISPLACEMENT USING A “WIDE 
OPEN" MASK (TOA = 47, TOM = Q). 


THE DISPLACEMENT NETWORK CONSISTS OF THREE CASCADED END- 
AROUND SHIFT STAGES WHICH ARE CONTROLLED BY ADJACENT PAIRS 
OF BITS IN THE SIX-BIT DIS REGISTER. 


FOR AN INSR K:L OPERATOR, THE DISPLACEMENT IS L-K-1 AND: FOR 
L = 48 THE FOLLOWING PARAMETERS CHECK ALL PATHS BETWEEN THE 
THREE INTERNAL SHIFTER STAGES BY TRANSFERRING BOTH A ZERO 
AND A ONE BIT FROM EACH 26 INPUT BIT POSITION TO THE 
CORRESPONDING Z1 OUTPUT BUS POSITION. THE TWO "CORRECT 
RESULT" COLUMNS CORRESPOND TO THE RESULT OF INSERTING THE 
DIS = 0 VALUES INTO A DESTINATION WORD OF ALL-ZEROES. 
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TABLE 


DIS 
(DECIMAL) 


OONOUN LS WN © 


10 


ee 


OLS 
(BINARY) 


00 
00 
00 
00 
00 
00 
00 
00 
00 
0 
00 
00 
00 
00 
00 
00 
O1 
01 
01 
01 


Ou 
01 
10 
li 
Ou 
G1 
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INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
IWSR 
IWSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
ITNSR 
INSR 
INSR 
TwSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
INSR 
IwSR 
INSR 
INSR 
INSR 
INSR 
INSR 
LivSR 
TSR 
INSR 
INSR 


47348 
46384d 
4538435 
44348 
43248 
42t4o 
4bi4g 
4o31gs 
39t46 
3d246 
37346 
36748 
35246 
B4HtMd 
33948 
32846 
31142 
30848 
29t45 
20448 
err4g 
20148 
23%43 
24ids 
23:48 
22%t4s 
21348 
20748 
19848 
13348 
17148 
L6%t4g 
15448 
14:46 
13448 
12:48 
11:46 
10:48 

924g 

8344 

7348 

6348 

5343 

4343 

3:48 

2t44 

1346 

0348 


CURRECT RESULT CORRECT RESULT 


0123456/789AB 
BO91LA2B3C4D5 
CUO4GDLISIEZGA 
602468ACF135 
BOL2I45O7BIA 
DAOILAY]H3CAD 
ACOQ4S6D159£26 
5602408 ACF13 
ABOL23456789 
VS0O9LAZB3CH 
6ACO4EBDIS9IE? 
35602468ACF1 
9AB012345678 
4055091a283C 
Z6ACOdBDISIE 
135602453ACF 
S9ARQL234567 
C4058091A2B83 
c26AC0430159 
F1356002468AC 
789430123456 
3C4U58091A28 
9R26ACO046015 
CF1356024684 
6789AK012345 
BICHDIBIILA2 
SIEZOACO4SUL 
ACF 135692464 
56789AB01234 
2B3C40580914 
I59E26AC048) 
BACK 13560246 
456799A30123 
A2B3C4D58091 
DLDIE2ZBACO4S 
63ACF13560024 
345674894012 
1A283C45809 
BSULSYEZHACU4 
460ACF135602 
23450789AB01 
91A203C40580 
4BD1IS9IE26ACO0 
2468ACF13560 
123456789480 
091A2B3C4058 
Q48D159E26AC 
O2468ACF1356 


FEOCUA98/7654 
TF6ESD4C3K2A 
3FB72ZEA61095 
YFDBI7TS30ECA 
4FEDCHA98/7465 
A7F6E5D4C 302 
5S3FB72E A019 
ADFUBY7S30EC 
SaFEDUBAI476 
2ATFOESD4ACIB 
9S3FB/2EA610 
CAIFDb9753I0E 
654FEUCBA987 
B2AfFOESD4aC3 
DISIFB72EA61 
ECAIFUB9I75S30 
7654FEDCBA96 
3BZA7FOESDAC 
1D953rB72EA6 
OF CASFDB9753 
B76S54FEDCBA9 
C3B2a7F 6E5D4 
61D9S3FB72EA4 
JZOECAIFDBI7TS 
987O54FEDCHA 
4C3IB2A7F6ESD 
ASGLODOD3FB7ZE 
5SIOECAIF DBI 
AI87654FEUCH 
DACIB2ZATF6ES 
FAGLINISIF B72!) 
7T5SSIOEVAIFDBY 
BAIB7654FEDC 
SDAC3U2ATFSEE 
Z2EAS1L0953F 87 
97530LCAIFDB 
CBAIA74654FED 
ESD4C3B2A7F6 
7TZEAGIDIS3IFB 
B97S3IVECASFOD 
DCBAIS7654FE 
6ESDACIB2ZA7TF 
B72ZEA610953F 
DBIT5SI0ECAIF 
ENCBAIB7TE54F 
FEOESDN4SCIBZA7T 
FB72EA610953 
FOBY7S5S30ECAI 
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HARDWARE FUNCTIONS: MASKING NETWORK BETWEEN Z6 AND 71 
BUSES 
OPERATOR: INSR 


THE SINGLE-ENDED OUTPUTS FROM THE STEERING NETWORK (TEST 13) 
ARE FED INTO ANOTHER COMBINATIONAL NETWORK CONTROLLED BY THE 
TOP OF APERTURE (TOA) AND TOP OF MASK (TOM) REGISTERS. THIS 
NETWORK GENERATES LOGIC LEVELS PTO0 THROUGH BT47, WHICH ARE 
TRUE IF BIT TRANSFER ONTO THE Z1 BUS SHOULD OCCUR. 


THE LOGIC EQUATION FOR TYPICAL: “BIT POSITION, NN, BEING 
TRANSFERRED ONTO THE Z1 BUS IS: 


BTNN = (TOA GEQ NN AND TOM LSS NN) OR 
(TOM GEQ TOA AND TOA GEQ NN) OR 
(TOM GEQ TOA AND TOM LSS NN). 


TEST. 14 PERFORMS INSR K:L. OPERATORS WHICH TRANSFER BITS FROM 
AN ALL-ONES SOURCE INTO ALL-ZEROES DESTINATION AND VICE- 
VERSA. WITH K:L VALUES SELECTED TO EXCITE EACH OF THE THREE 
OR TERMS IN BTNN. 


TABLES 14.1 THROUGH 14.4 SHOW THE VALUES OF K, L, TOM, TOA, 
THE CONTENTS OF THE Y REGISTER AT JB = 109 (IN BINARY) AND A 
BIT REPRESENTATION OF THE Zi BUS IN WHICH: 


"—"= NO DATA TRANSFER (B-REGISTER BIT NOT CHANGED 
AT JB=113), 

"X" = TOA GEQ NN AND TOM LSS NN 

"Y" = TOM GEQ TOA AND TOA GEQ NN 

"Z" = TOM GEQ TOA AND TOM LSS NN. 


FOR THE "Y" AND "Z" CASES, THE TOM GEQ TOA IS GENERATED BY A 
SPECIAL SIX-BIT COMPARATOR WHOSE OUTPUT IS DESIGNATED "MGEA" 
("MASK GREATER THAN OR EQUAL TO APERTURE") IN THE LOGIC BOOK. 
TABLE 14.5 SHOWS THE COMBINATIONS OF SOME ("MM") AND TOA 
("AA") VALUES WHICH SHOULD CAUSE MGEA TO BE TRUE; THE "PIN" 
COLUMN REPRESENTS THE LOGIC PIN ON WHICH THE RESULT OF THIS 
BIT COMPARISON APPEARS. 
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TABLE 14.6 SHOWS THE OR TERMS WHICH ARE USED TO DETERMINE 
THE TOA GEQ NN AND TOM LSS NN CONDITIONS FOR THE 48 POSSIBLE 
VALUES OF NN IN THE BTNN EQUATION. 


153 


eres 


INSK Ri HARDWARE PARAMETERS 


PROCESSOR VERIFICATION TESTS 


HEE 


TUA 


590 


4 


~ 


DO 
MABLE 14.1 


S002 


OWNS 
Ters 
0 os oc ow 
ROMS 
wzvas27 


20090 


MAS 
rtatz 
oe of: oF oF 
MAAS 
oe 


Scaco 


MOro 
mo Oy 
oui ce onion 
Dono 
mame 


Coots 


insmod 
bapa las i927] 
ot oe os ow 
inser 
PPLE FY 


oOvoOo 


mAOnD 
HY AID 
oe ce ce ow 
mMOawd 
MONA 


Dooce 
DSaIOD 
pa Ler Bee Len 


ADDS 
BoDOD 
BOooo 


coco 
a5>30 
ctoteict 


mon 
NOIOIOT 


oooSo 


mons 
NNENAD 
20 0 oe we 
MOMS 
NAINA 


Ce ee ee Ee 


MAMAS 
NNNAL 


oooo 


BAAS 
NAAIN 
oe 00 00 ce 
MAKAKS 
NNN 


cOOoD 
BSoloa5 
Soc0c 


Da oS 
ooo 
DDO 


oostf 


BOoS3 
tet tet 


ON. 
Set tet 


oooD 


Ce eee ee 2 


Ce ee ee ee er ee ee 
ne ee oe oe ee ee a a 
Ce ee ee ee ee 


ax E 


Meme ee lm ee a 


ata eON eRe RMON Rese a Se wp ee ee 
em em en ge ee | oe a Pe gy Pa a 


Co eS ee 


D303 
Doos 
ao00D 


sobs 
o>a2 
3BO30 


coco 
23900 
aici 


mHtOnD 
eet 


oso0o 


etOOD 
wt 
oo oe cee 


mMOngD 


rte 


Fen eee se Oe Rem a a me mm fe 
Ce ee ee ee ee ad 


Oe Oe oe 


NTN NAM Sess SAO ee mY YX YX 
ese een eee ee YK 


een ROOK Reese SF Zen Psa mm wo YX Xo 
Caatnenen BTA ee ae eee OF FSS Sas Qe mae wee oe 


MAIKO 


oooeS 


MNS 


ee ce ee co 


ANAS 


BT 


TOA 


222 
2ZzZz 
NE 

ABW 
DOO vs 
eS 


a be 
WorD 
18 ld od 
x= 

Woos 
wWwFAAsz 
Waitt 
pra 

<<2a<a 
TZ235 
- ee 


r33aS 
Oidudil 
2355 


ete e 
—3439 
Beer 
nin 
rA>N 


154 


eg7=iysas °F 


bT 


INSK KEL HAKUWARE PARAMETERS 


PROCESSOR VERIFICATION TESTS 


Mee 


TOA 


DO390 


MAD 
NANN 


ad 
oi a 


TANest 
MINION 
ANAS 
AIOINION 


~se 


Sees e2Fn ae neers ms 
sen 2 eaeees FR eee Rae 
ete nee fee ee ee 


wean toa RET ee hee Ree Ee Beene n woamy 


tated 
Siete 
steaest 


tt 
asst) 
et tt 


rete 
mit tt 


Sosof 


AOAD 


Shand 


Le ld 
wag 


NRA On 
tet 
oe on oe ow 
MAOanD 
wie 


enema gn ennean a 
Ree een eae 


nanan 
aera nee 


MNS 


RAN 
oo od 


FON]? 


+ on ce ow 


ANMOS 


BT 


TOA 


ZZ 
m2 ZZ 
N 

maw 
DIM 
mS 


QIZzat=e 
ee ism Few bean} 
rere 
x 

Wwoana 
in 
Wat td 
Zz 

acta 
XZ33 
—- ee 


KGIs 
Dosis 
ZO33 


ears 

333 
tere 
HRW 
Ex>N 


155 


p72 


PROCESSOR VERIFICATION TESTS 
bT 


INSRK Rik HAKL WAKE PARAMETERS 


Hee 


DO390 
TUA 


TABLE 14.3 


>> > 
Neus 
N™NEOSE 
NNNE 
NNN™N 
NWINININS 
NINNEN 
NNN 


NINN™N 
NNNN 
NNNIN 
NNNN 
NINENEND 
SEN NEN 
NININN 
NININING 


NSINNN 
NININEN 
NNNN 
NNN ™~ 
SINAN ™N 
NNENN 
NN NN 


NEN? 


SINNA 
NNANN 
NEN NN 
ANAS 
NINENENG 


NINNN * 


NENN ON 
NINEN™N 
NANNN 
SENN 
SNENE™N 
AINANN 
NNNN 
INNS 
NNNN 
SENN 


NNN 
NINNN 
ENN 
NNN 
SENN ON 
SENN ON 
NNN 
NNWNN 


De D- 
Docd 
voocs 
2529053 
acti 
OoamIs 


ttt 
tt 
S355 


oooo 


aNM 


On.01N 
rw272 
Se eajasvas. 


Sooo 


SOD2D 


rTNoOM 


ITMNet 
ra@9r72 
sae ac ce 


oooo 


Z™ eanewanly 
-_- amaononm\y 
mm sanewany 

eancwany 


So 30 


DADO 
tt 


OAR 
Se 
oo ae oe ce 


oooo 


Ziueaee narenen 
/maesan wseatunny 
ennenmn maanwamy 
neu aaae mwaaenowy 


o000 


NM son 
etetetet 


wns 
SANTEE 
or oe oa oe 


oo°0o 


i* ane senae see eme mY 
Cee 2 oe 2 euneenany 
ss sme eee asaanueany 
aan pe meagan sesawawy 


fn Lan be oe) 


o~ DOD 
Stet tet 


Neston 
TIC PAE 


oe ee eo ce 


ooo0So 


Lusasese aernmaene asnesteaw y 
7, serene aera eeeewe wy 
TsO aR aa mam 


ZZZaatee anamwaewa wsawecawny 


Sooo 


SAN 
NAAN 


oR. OLN 


Y 
Y 


Zidn ee eg SF a oe a waamane ¥ 
Euocedioees ceesasa5enaeece 
aon BERNE SUT ea wowe 


oooo 


INO 
NANA 


IMA 
MEMO 


Y 


sen ase es eR ona ee evan enmeay 
aman e se CR we uaavweanly 


ete en ne asenae seawe ew \ 


Ziiveurm 


Coooo 


DRO 
NINO 


OOon. 
Ol tat et 
we ee ce of 


DOr "ASOSCO 


me oe ee ee ae anaseany 
Ce el Riel saasenay 
Ce ee el noaamanmy 


iin ae et ee ee ee ee aseeeunny 


ELL mamenane 
Zc°7 


ooo0o 


A? SF 
SAC OY 


OLN ST 
wet etet 
oe ce sece 


ocoeo 


"AH ST HS Ean nea ew 
ee Reed wsoaumaanmy 


mune iene ewan an HRSA senwaewy 
ee ee ee Be eed maenmaaany 


g 
Z 
é 


Sooo 


On OH 
POY 


NAOn 
tt 
ea ce oe ee 


cooo 


Y 
Y 


anna Fan BUH eens nana em 
wt Oy eo ee a Pe a a awa amy 


ian eRe HOM? HOA SST a 


ooosS 


DaNy 
tad9 


bo] ola) 


oe ue re ce 


oooo 


ed ee de ed el avecuenwy 

aan SRS mm 
Cee ee. ee ee 2 omaomanany 
ee oe ee ee ee 2 enameawly 


7 ee 


LZ2i7=man ee et Oe 
LELaomnmnn 2 em 
Laan an a ean on 
Ce ee 


Soos 


rnomM 
rasIa 


FON 


eo we oe of 


Oooo 


BT 


iwN 


NOT TRAN 


GE 
wey TOA 


vba TOA 


00 


loud 000 
Y 


15& 


(ye eee 


BT 


PROCESSOR VERIFICATION TESTS 


INSR AEL HARDWARE PARAMETERS 


nee 


o0s30 
TOA 


TABLE 14.4 


>>> 
>>> 
>>> 
pp ee aad 
poeta 
>>> 
>> 
>>> > 


>>> 
>> 
>>> 
bead 
>>> 
ee 
>>> > 
pb abe 


> 
>>> 
>>> 
>> 
>>> 
> 
>>> 
>>> 


>> 
>>> 
>>> > 
ae 
>>> 
>>> 
>>> 
>>> > 


ead 
Poet 
ee 
>>> 
> 
>>> > 
St id 
> 


an aad 
a a ala 
>>> 
eee 
he aia 
> e~ 
RENN 
> NNN 


ADA 
at DD 
cette’ 


atest 
tHe 
ete 


Steet t 
tt 


fom he bap Ran] 


™ OW” 
reas 


™~ OS 
o-oo 2 


SOOO 
tTIr792 
oo we ce ce 
hRons 
i oo 4 


>>> 
=> >> 
eed 
>>> 
>> 
>>> 
> 
>>> 


>>> 
alt a ial 
>>> 
pbb 
> > 
Se 
>>> > 
>>> > 


>> >> 
> > 
pba 
bebe 
en 
>>> > 
ee 
ead 


>>> > 
> > 
>>> 
>>> 
>>> 
Sem 
See > 
reed 


pea aaa 
>> 
>>> 
>>>> 
>> >> 
peered 
>>> 
>> 


>>> 
> NS 
> NIN 
>NNN 
NNNAY 
NNN™ 


HACKS 
aS DD 
Dsoco 


tt ent 
tet 
th tet 


tet tes 
Asset 
oo75 


MINAS 
2 


MINAS 
wsaS 


DOoo 
<2 2 
ee ae os ce 
MmNAS 
wzw2e372 


> 
>> 
>>> 
>>> 
peered 
>>> 
>>> 
>>> > 


>> 
Sera 
>> 
baad 
rod 
rd 
>> 
>> >> 


>_> 
>> >> 
>> >> 
eee 
>> 
>>> > 
>>> 
Se 


>> 
> 
>>> 
>>> 
>>> > 
>>> 
5 ad 
oP ee ad 


>>> 
~~ 
>>> > 
>>> 
ee Pad 
>> eeN 
>> NN 
m>NNN 


NNNN 
NNN™N 
NANNN 
NNNN 
NNNN 
NNNN 
NINININ 
NNNN 


SOHO 
ma DO 
wie ctet 


atest 
Son hea haeadaed 


atetet 
Att 
SpocD 


ADR O 
Mmmm 


BOrDO 
Ar CAM 


WOOO 
wert 
ot of of oo 
AOR O 
mA eA. 


>>> > 
>>> 
aa 
>>> 
ee 
>>> > 
>>> 
>>> > 


pe ad 
creme 
>_> >> 
>> > 
cpt 
pee ae ad 
>>> > 
>>> > 


>>> 
>> > 
> > 
tama 
red 
>>> 
>>> 
>> 


>>> > 
rata 
>>> > 
>>> > 
>>> > 
>>> 
>>> 
>>> 


>>> > 
> eN 
NIN 
>NNN 
NNININ: 
NINNN 
NNN 
NINININE 


SININN 
NNN 
NNNN 
NNNN 
NNNN 
NNN™N 
WN SI 
NNNN 


ADA S 
alo 
SooS> 


orTosS 
asta 
atte tt 


ate 
ttt 
DSDooOoO 


WAS MAA 
mamMny 


WIM 
mmo 


MODs 
T2377 
oe oe 08 Oe 
wWsAN 
CALORIE COD 


>>> > 
>>> > 
>> >> 
>> 
>>> 
>> 
>> > 
>> >> 


> 
Peete 
>>> 
>>> 
ee > 
ee 
>> >> 
> 


> ee 
> 
aa a 
erated 
>>> 
>>> 
>> ee 
>>> 


pore ee 
>>> 
ed 
ees 
>> >> 
>> N 
hENN 
NAIN 


NNNN 
NNNAN 
NINN 
NININN 
NNNIN 
NINAN 
NINN 
NINENING 


AININEN 
NNNN 
NNINN 
NNN™N 
NININING 
NNNN 


ad 
aH SO 
AS 


Sette 
DO00 
Aste 


Stet te 
ttt 
ooos 


MAOAD 
moa 


TMORD 
CHA OIAL 


O00 coc 
wasa7 
oe ae oe ow 
AOD 
THIONION 


>> 
>> >> 
2 ee 
>> >> 
> ee 
>>> 
>>> 
>>> 


5 aed 
> 
>>> 
>>> 
>>> 
>} > 
>>> 
>>> 


>See 
>>> 
>>> 
>>> 
Seed 
>>> 
ard 
>>> 


» aaa 
>> oN 


> NENENT 


NNNENE > 
NINN > 


ININININS 


NNNN 
NNNN 
NININAL 
NENENINT 


NNNN 
AINININ 
NNN 
NNN 


asad 
aAADO 
S000 


am anten) 
DSaeo 
eee hen hee toed 


ast ett 


att 
eooS 


BR OUISS 
AINA 


~ CMS 


NNAIN ¢ 


O00 070 
avo37 
ot ce 20 oe 
nRoOnT 
NOUN 


>>> > 
>>> 
Pee aah oP aed 
>>> > 
>>> > 


>> >N 
>>NN 


NINNNG 
SENININS 
NININIAT 


ANINEINING 
NININAN 


NEANENN 
NININIAT 


NINNND > 


NNN 
NENIN™N 


NINN > 


ANINNN 


NNN™N 
NNNA 
NNININ 
SENN 
NNN 
NENININY 
NNENN 


NNN™N 
NAWNA 
NINAUIN 
NINNAY 
NNN 
NNANN 


NNNN 
NNN™N 
NNNN 
ININN™GE 
NNN™N 
NNNN 


“oO D 
at OD 
tetetet 


BOooom 
ate 


SocS 


tat 
att 
oooSo 


~ OuyaT 


ONS 


Moa wo 
rasa 


OWS 


NINININT 
NNN™N 
NINININ 
NINGIN 
AINNAN 


SENN 
NNN™N 
NNNAN 
NNNN 
NNNEN 
NNNA 


NAINN 
NSAIN™N 
ee 
IWINENIN 
SNN™ 


AI HtO 
aAAOS 
2000 


OoosD 
raetetedt 


Sooce 
Aste 


Att 
oocof 


MINAS 


ANAS 


DWOwow 
waa7 


TNAIS - 


bT 


TOA 


222 
WZ Ze 
Ni 

waw 
BHI 
5S 


Sorte 
pos few fae Tew} 
Yreee 
= 

wool 
in 2AZ 
Nt 
2 

a2 
r2e053 
- —e 


—- ABs 
pom EEN OE EET 
2555 


eats 
ee ee ee I 
bere 
LU a 
axon 


7 
m= aystisas 


- PROCESSOR VERIFICATION TESTS 


ace 


DOSS 


DO 


TABLE 14.5 


@eeanaan 


2xu3wraza 
—IADAMNN 
aA rErrrut 


MM'AA FROM MelLis2]'aA,l132) 


e ected e<ct<ct 
eetd ect 
at eo eSoct e¢ 
Coop Dp +e 
eoeeeeeees 
eee@es8tes#ee 


° 
e 
"| 
M 
a 
"i 
1 
e 


Zz2zxweaxrvaxd 
TINE II VG 
Awa Sato 


MMMM AAAA FRUM MeL3t4)]tA.(324) 


eect ett 
e eet e-tet 


eect eta 
Qe exnt<t ext at 


2axeaoroaxur 
LeODVo oA 


EXAMPLES 


Li2)*TOAelit2), 


— S 


ae 
mm 
Br See 35 0 


2 
— 


ee 


H3P *OR® HIN OR" ESP. 


H3K "OR" 


TUMeLis2]'TUA,C Lig) 


159 


~ 07-14-73" AF 


- PROCESSOR VERIFICATION TESTS 


MCP 


PIN LUCATIUNS FUR "UR* TERMS IN TOM/TOA DECODING, 


pps29 


TABLE 14.6 


+ t$+4 
2eazawrou 
MIAMI ALN a OS 
IOVOSBOoOL 


SOROS FL ORD 


VvvVV¥VVV Vv 
i a ie 


Baa 32093 
OREN MAN 
DOA OW 


ANION STLAOR 


Sah CIC 
Pr eeeee 
Ma2zaz7axr 3 
Natt Net OD 
BJ. SI Ouso 


AOMAIM AINA 

Mette 
VvvvvVVVV 
SEES ET=E 


BZD ZO 
oocoosscoo 
TIrESoAADS 


BS AM TU O 
ht tet tet et 
eer eee eee 


Attetcatqaod 


x 
~ 
peed 
+ 
< “2M 
No ctrtee 
Oo Ans 
+ ++ 4 
M<Yew¥MAANwaAS 
NN Alte 3D 
VOD Lhe De 
+rttir+ ee 
22z222¥e 2a 
TONAL ttt tet 
SoawWJou nes 
BRO eM 
wet ot NII OIL 
VVVVV¥V VV 
SELTTSETTE= 
> 
LO 
a 
bs 
Ooms 
mmo 
MOIS 
NIM DAS 
IN tt 


are 27arvar Zs 

RZINVN GHA 

MDCtouUNIa De 
tether ee 
Mi2ea4a 20 
CTO 9D Fa 
t+teetett+r et 
GUZ DR ZI 
CsB0O DAO oH+ 
DVUMaa we 


NOROKMKNIMS 
wae tN ONIN OO 


eweeereee ew & 


ait taatgce 


Zax<e222e2 
MKNAIN tt OI 
ON tod Din. 


WG DAS tty 
NIQINIAIOIM Me 
VVVVVV VV 
STEEZTETE 


2 WZuZzZzun 
HNN tN et OO 
DulolWOw win 


WON. ORO aN 
ATOLAT AEN Or 


oer ee & & 


taiteaeatatacdt 


> 
Qa2227zara2 
MN A atest Qt: 
Ot DROW 
torte ese oe 
VVDBu Dun 
CtDVESihhit 


MSU OR SAS 
AMMAMMOmMAMmt 
Vv¥VWVVVVV Vv 
Sz TLTTTTET 


ST Yaw FFAS 


VUOVUIDTD 33 
tee eerte et 
2eaw~awrare 
NN SR AAAIOO 
VCOOCUAIao 


eee ee woe 


tot totettaeat 


ANIM TOR 
aerorss72 
VVVVVV¥ 
ZSEZELE=z 


SEN M TIN ON 
warewewsa ss 


cee ee ee 


CAtNN)) 


PAGE 159 


DO380 MCP - PROCESSOR VERIFICATION TESTS —- 07-14-73 


+B: 


HARDWARE FUNCTIONS: ATAA, BTBB, CCTB 
OPERATORS: ADD, SUBT 


TEST 15 CHECKS THE DATA TRANSFER TO AND FROM THE ARITHMETIC 
ADDER AND THE ADDER CARRY/BORROW LOGIC. 


THE CARRY TEST CONSISTS OF ADDING 38 VALUES CONSISTING OF A 
WORD OF ZEROES WITH A SINGLE ONE-BIT IN BIT POSITIONS ZERO 
THROUGH 37 TO AN OCTAL VALUE OF 3777777777777. 


OPERANDS OF ZERO WITH A SINGLE ONE BIT IN BIT POSITIONS ZERO 
THROUGH 38 FROM AN OCTAL VALUE OF 4OOO000000000. 


THE RESULT OF THE ADD AND SUBTRACT OPERATIONS ARE COMPARED 
WITH THE CORRECT RESULTS USING THE SAVE OPERATOR. 


HARDWARE FUNCTIONS: ATZ5, 2Z2&7TB, CIZ6,. ZITB, Z1ITC, ZeTB 
OPERATOR; RSUP 


THE TOP THREE STACK WORDS ARE INITIALIZED TO BIT PATTERNS OF 
ALTERNATE ZERO AND ONE.BITS, ALL-ONES AND ALL-ZEROES. THE 
RSUP OPERATOR IS THEN EXECUTED THIRTY TIMES AND THE TOP 
THREE WORDS ARE CHECKED FOR EQUALITY WITH THEIR ORIGINAL 
VALUES USING THE SAME OPERATOR. 


THE HARDWARE FUNCTIONS VERIFIED BY TEST 16 INCLUDE THE CTZ6 
AND Z1TA LEVELS WHICH WERE PREVIOUSLY CHECKED BY LTS AND 
LT16 OPERATION IN TEST FOUR. HOWEVER, THE TEST FOUR LT16 
CHECK USED ONLY THE LEAST SIGNIFICANT 16 BIT OF THE C- 


REGISTER SO THAT TEST 16 IS THE FIRST VERIFICATION THAT ALL 


48 BITS ARE TRANSFERRED CORRECTLY TO THE Z6 BUS BY THE CTZ6 
OPERATION. 


OTHER INTER-BUS AND INTER-REGISTER CONTROLS USED BY TEST 16 
WHICH HAVE BEEN VERIFIED BY PRECEDING TEST INCLUDE ATZ6 
(EXCH), BIZ6(DUPL), CTC6(LT8, LT16), AND Z1ITACOPL). 


HARDWARE FUNCTIONS: XTZ4, YTZ4, Z3TY; LOTK, LOTJ; LOTU, 
L1TK; WSML, BUOZ 
OPERATORS: SAME, DUPL 


DO390 MCP — PROCESSOR VERIFICATION TESTS - 07-14-73 
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TEST 17 IS THE BEGINNING TEST IN THE SEQUENCE OF HARDWARE 
VERIFICATIONS WHICH USE DOUBLE-PRECISION DATA. THE PURPOSE 
OF THIS TEST IS TO ESTABLISH CONFIDENCE IN THE ABILITY TO 
DISTINGUISH BETWEEN EQUAL AND UNEQUAL BIT PATTERNS IN THE 
SECOND WORD OF A DOUBLE-PRECISION OPERAND. 


THE TEST ALGORITHM CONSISTS OF PERFORMING THE SAME 


“OPERATIONS AS THOSE USED IN TEST THREE ON OPERANDS WHOSE 


FIRST WORD IS ZERO AND SECOND WORD IS THE BIT PATTERNS USED 
IN TEST THREE. 


HARDWARE FUNCTIONS: XTZ4, L1ITJ, Z3TY 
OPERATOR: LOR 


TEST 18 PERFORMS THE SAME TEST ALGORITHM AS TEST EIGHT., 
USING DOUBLE-PRECISION OPERANDS CONSITING OF A FIRST WORD OF 
ZEROES AND A’ SECOND WORD IDENTICAL TO THAT USED BY TEST 
EIGHT. 


THE RESULT OF THE OR OPERATION IS CHECKED BY COMPARING IT 
WITH THE EXPECTED RESULT USING THE SAME OPERATOR. 


HARDWARE FUNCTIONS: AVZA is LO, LiTK:. 2StX 
OPERATOR:  LNOT 


TEST 19 APPLIES THE ALGORITHM OF TEST NINE TO A DOUBLE- 
PRECISION OPERAND CONSISTING OF A FIRST WORD OF ZERO AND A 
SECOND WORD CONSISTING OF 24 CONSECUTIVE PAIRS OF O01 BIT. 


HARDWARE FUNCTION: XTZ5, ZeTY, TYZ6, Z1TX 
OPERATOR: EXCH 


TEST 20 VERIFIES THE INDICATED DATA TRNASFERS OF THE SECOND 
WORD OF DOUBLE-PRECISION OPERANDS BY LOADING THE STACK WITH 
TWO OPERANDS CONSISTING OF A FIRST WORD OF ZEROES AND SECOND 
WORDS OF HEX AAAAAAAAAAAA AND 955555555555 AND THEN 
PERFORMING 24 EXCH OPERATORS. THE TOP TWO STACK WORDS ARE 
THEN COMPARED WITH THE ORIGINAL VALUES USING THE SAME 
OPERATOR. . 


HARDWARE FUNCTIONS: XTZ6, Z1MB 
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OPERATOR: NTGR 


THE COMBINATION OF XTZ6, TOA = 47, TOM = OQ. AND ZIT 
<ANYWHERE> IS NOT PRESENT IN THE LOGIC FOR ANY EXISTING 
OPERATOR. THE APPROXIMATION TO THIS DESIRED SEQUENCE WHICH 
WE USE TO CHECK THE XTZ6 REGISTER-BUS GATING THEREFORE WILL 
NOT DETECT ERRORS FOR ALL BIT POSITIONS IN THE X VALUE. 


THE TEST ALGORITHM CONSISTS OF PERFORMING AN NTGR OPERATION 
ON THE VALUE DOUBLE (3"0140000000000007" ,3"0007777777777770") . 
THE HARDWARE COMPUTES THE CORRECT ANSWER IN TWO 
DISTINGUISHABLE STEPS CONSISTING OF SHIFTING THE MOST 
SIGNIFICANT MANTISSA WORD LEFT BY TWELVE OCTADES (USING THE 
DAM1 OPERATION AT JA = 2 * NTGR) FOLLOWED BY SHIFTING THE 
SECOND WORD MANTISSA OCTADES INTO THE "EMPTY" POSTIONS OF 
THE B-REGISTER (USING THE DAM2 OPERATION AT JA = 05 * NTGR). 
THE RESULT OF THE OPERATION IS CHECKED FOR EQUALITY WITH 3" 
00077777777777" USING THE SAME OPERATOR. | 


THE SAME TEST SEQUENCE IS THEN PERFOMRED ON AN OPERAND VALUE 
OF DOUBLE (3"0140000000000004",0) IN ORDER TO CHECK THE 
TRANSFER OF ZERO BITS F xX TO B. THE EXPECTED (CORRECT) 
RESULT IS 3"0004000000000000". 


HARDWARE FUNCTIONS: CHARAC®ER COMPARISON NETWORK 
OPERATORS: CLSD, CEQD, CGTD 


THE STOPPING CONDITION FOR STRING SCAN OPERATORS AND THE 
DETERMINATION OF THE VALUE OF THE TFFF FLIP-FLOP FOR STRING 
COMPARISON OPERATORS ARE CONTROLLED BY A_ COMBINATIONAL 
NETWORK WHICH COMPARES TWO-BIT FIELDS IN THE SOURCE AND 
DESTINATION CHARACTERS. THE THREE OUTPUTS FROM THIS 
COMPARATOR ARE LEVELS SEQD/ ("SOURCE EQUALS DESTINATION 
NOT"), SERR ("SCAN ERROR") AND SERR/ (WHICH IS NOT THE 
COMPLEMENT OF SERR) WHICH ARE USED AT JG = 3 IN THE HARDWARE 
FLOW DIAGRAMS. . 


TEST 22 CHECKS THIS CHARACTER COMPARATOR BY EXECUTING CLSD, 
CEQD AND CGTD OPERATORS USING FOUR, SIX AND EIGHT-BIT STRING. 
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DESCRIPTORS WHICH POINT OUT CHARACTERS OF ALL-ZEROES AND 
ALL-ONES WITH TWO-BIT SUBFIELD OF BINARY 01, 10 AND 11. FOR 
EACH OF THESE TEST CASES, AN ENTIRE 48-BIT WORD IS FILLED 
WITH THE CHARACTERS UNDER TEST SO THAT IMPROPER OPERATION OF 
THE CHARACTER-SELECTION LOGIC WILL NOT INFLUENCE THE OUTCOME 
OF THE COMPARISON. 


EACH SUCH TEST CHARACTER IS COMPARED WITH ALL’ TEST 
CHARACTERS FOR THE CORRESPONDING CHARACTER SIZE. 


THE RESULTS OF THE TWO-BIT FIELD COMPARISONS WHICH ARE UNDER 
APPEAR AT THE FOLLOWING LOCATIONS ON SCHEMATIC D-2330 8745 > 


SOURCE.[1:2] > DESTINATION.[1:2] ABJI6 @ HIiJ 
= H1iP 

Looe) 2 [Seed GiJ 

— H1F 

{5:e2] > [5:2] EIF 

es H1B 

[Peel > [7:2] GIF 

= Hic 

[7:8] > [7:8] H1K 

- H1N 


HARDWARE FUNCTIONS: SOURCE AND DESTINATION CHARACTER 
SELECTION NETWORKS FOR STRING COMPARE 
OPERATORS: CEQD, CNED 


THE STRING COMPARISON OPERATORS USE THE CHARACTER SIZE AND 
CHARACTER INDEX FIELDS OF THE SOURCE AND DESTINATION 
POINTERS TO SELECT INDIVIDUAL CHARACTERS FOR COMPARISON. 
TEST e@2 VERIFIES THAT THE CHARACTER SELECTION NETWORKS WORK 
CORRECTLY FOR FOUR, SIX BND EIGHT-BIT STRING DESCRIPTORS. 


FOR EACH CHARACTER SIZE, A STRING DESCRIPTOR IS CONSTRUCTED 
WHICH POINTS TO AN ALL~ZEROES CHARACTER IN A WORD WHOSE 
OTHER BITS ARE ALL ONE; THIS “DESTINATION" CHARACTER IS 
COMPARED WITH AN OPERAND OF ALL ZEROES USING BOTH THE CEQD 
AND CNED OPERATORS. AN UNEQUAL COMPARE CONSTITUTES AN ERROR. 


seh. 
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THIS TEST IS REPEATED WITH THE STRING DESCRIPTOR POINTING AT 
EACH OF POSSIBLE CHARACTER POSITIONS FOR THE CURRENT 
CHARACTER-SIZE. 


AFTER COMPLETING THE DESTINATION-CHARACTER-SELECTION TEST 
DESCRIBED ABOVE, EACH OF THESE DESTINATION CHARACTERS IS 
COMPARED WITH SOURCE CHARACTERS OF ALL-ZEROES SIMILARLY 
SELECTED FROM A WORD OF ONES USING A SOURCE STRING 
DESCRIPTOR. 


HARDWARE FUNCTIONS: ISRT ("INSERT MATRIX") NETWORK 
OPERATOR: SEQU 


THE CONDITIONAL STRING TRANSFER AND STRING SCAN OPERATORS 
CONSTRUCT A 48-BIT WORD OF DUPLICATIONS OF THE COMPARISON 
CHARACTER AND USE THE NORMAL CHARACTER-SELECTION AND 
CHARACTER-COMPARISON NETWORKS VERIFIED IN TESTS ee AND 23 TO 
DETERMINE WHETHER THE SCAN/TRANSFER OPERATION SHOULD 
TERMINATE WITH THE CURRENT SOURCE CHARACTER. 


THE CONSTRUCTION OF THIS WORD OF DUPLICATIONS OF THE 
COMPARISON CHARACTER IS PERFORMED AT JG = 2, PX2 OF THE 
HARDWARE FLOW DIAGRAMS; THE ISRT = 1 AT KG = O ACTIVATES A 
COMBINATIONAL NETWORK WHICH ACCEPTS A 4-, 6-, OR 8-BIT 
CHARACTER FROM THE Z5 BUS AND PRODUCES SIX, FOUR OR THREE 
DUPLICATES OF IT ON THE Z2 BUS. THE Z6:Z1 SHIFT NETWORK IS 
THEN USED TO FILL THE MOST SIGNIFICANT HALF OF THE 
COMPARISON WORD WITH A DUPLICATE OF THE LEAST SIGNIFICANT 
HALF, USING THE TOA/TOM VALUES SET AT JG = 1 * KGIF AND THE 
DIS + 24 SETTING AT JG = 2. i 


TEST 24 CHECKS THE OPERATION OF THIS’ ISRT DUPLICATION 
NETWORK BY PERFOMRING A SEQU OPERATOR USING A CHARACTER 
COUNT WHICH CORRESPONDS TO ONE FULL WORD OF CHARACTERS IN 
FOUR, SIX AND EIGHT-BIT CHARACTER SIZES AND 


1. A STRING DESCRIPTOR POINTING AT A WORD OF ALL 
ZEROES WITH A  COMPARION CHARACTER OF ALL ZEROES, 
AND 


uy 
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2. A STRING DESCRIPTOR POINTING TO A WORD OF ALL ONES 
WITH A COMPARISON CHARACTER OF ALL ONES. 


CORRECT OPERATION OF THE SEQU CORRESPONDS TO HAVING AN 
UPDATE CHARACTER COUNT OF ZERO AND THE TFFF FLIP-FLOP EQUAL 
TO TRUE; BOTH CONDITIONS ARE CHECKED. 


3.25. HARDWARE FUNCTIONS: SCAN-BUS DATA VALIDITY AND PARITY- 
CHECKING 
OPERATOR: SCNI 


TEST 25 PERFORMS TEN EXECUTIONS OF THE FOLLOWING CODE: 


LT8 20 INTERROGATE PERIPHERAL STATUS 
SCNI 

DLET 

‘LTS 60 READ TIME-OF-DAY CLOCK 

SCNI 

DLET 


THE OBJECT IS TO EXERCISE THE SCAN BUS AT A RELATIVELY HIGH 
DUTY CYCLE IN ORDER TO DETECT BOTH SCAN PARITY ERRORS AND A 
"DROPPED BOUNCING BALL" IN THE SCIL SCAN-CONTROL LOGIC. 


IV. RESOURCES USED 

THE 2.5 RELEASE OF THE MCP PROCESSOR TEST USES APPROXIMATELY 3800 
WORDS OF MEMORY FOR STACK, CODE AND READ-ONLY DATA. EXECUTION TIME 
FOR AN ERROR-FREE RUN REQUIRES APPROXIMATELY 950 MILLISECONDS ON A 
MACHINE WITH 1.2 MICROSECOND MEMORY, AFTER THE CODE SEGMENT AND 
READ-ONLY ARRAY OF TEST DATA HAVE BEEN MADE PRESENT. 


DO391 MCP - LIBRARY MAINT IMPROVEMENTS -—- 07-14-73 


LIBRARY MAINTENANCE FILE HANDLING HAS BEEN EXTENDED TO INCREASE THE 
NUMBER OF FILES WHICH MAY BE COPIED BY A SINGLE OPERATION FROM 999 
TO A MAXIMUM OF 8191. 


CORRECTIONS HAVE BEEN MADE TO INPUT REEL SWITCH HANDLING TO 


D0391 MCP - LIBRARY MAINT IMPROVEMENTS - 07-14-73 "ACE 15° 


ELIMINATE SUCH PROBLEMS AS INCORRECT FILE NAME WHEN REQUESTING THE 
NEXT REEL AND “UNEXPECTED TAPE DIRECTORY" ERRORS AT REEL SWITCH 
TIME. THESE PROBLEMS COULD OCCUR ON ANY MULTI-REEL TAPE BUT WERE 
MOST PREVALENT WHEN VERY SMALL FILES WERE INVOLVED. 


THE EXTRA ARRAYS, CREATED WHEN STATEMENTS OF THE FORM "COPY 
<DIRECTORY>/=" ARE USEU, ARE NOW OVERLAYABLE; THUS REDUCING SAVE 
CORE REQUIREMENTS. 


DO: EE 2 a eee ea eee ee, Ol eee 

THE MCP WILL NOW IGNORE ANY ATTEMPT BY A USER PROGRAM TO 
PROGRAMMATICALLY DS OR ST A STACK HAVING PRIVILEGED STATUS (I.E. 
AN MCS. OR AN INDEPENDENT RUNNER) UNLESS THE STACK ATTEMPTING THE 
ACTION IS ALSO PRIVILEGED. 


DOW10 «MCP - CRUNCHED FILES - 07-29-73 

A NEW RUN-TIME OPTION, "CRUNCH" (OPTION 16) HAS BEEN IMPLEMENTED TO 
ALLOW FILES TO BE CRUNCHED. A CRUNCHED FILE IS ONE ON HEAD-PER- 
TRACK DISK OR DISK PACK IN WHICH UNUSED SPACE IN THE LAST ROW OF 
THE FILE IS RETURNED TO THE SYSTEM. WITHOUT THIS OPTION SET, NO 
CRUNCHED FILES WILL BE CREATED. NOTE, HOWEVER, THAT PREVIOUSLY 
CREATED CRUNCHED LIBRARY FILES COPIED TO DISK WILL BE COPIED AS 
CRUNCHED. WITH THE CRUNCH OPTION SET, FILES WILL BE CRUNCHED IF 
THEY ARE EXPLICITLY CLOSED WITH CRUNCH; AND CODE FILES ARE 
AUTOMATICALLY CRUNCHED. 


PLEASE REFER TO MCP-I-O DO398 AND ALGOL DO366 FOR INFORMATION ABOUT 
CREATING CRUNCHED FILES. 


PA 6 
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DO4S0 MCP — SWAP OF DIRECT ARRAYS - 08-12-73 


IT IS NOT LEGAL TO SWAP DIRECT ARRAYS. 


Benes). “IVE. --5 EROGRANDUME “AND OLACK OVERELOW. “= 0S=les73 

PROGRAM DUMP WOULD QUIT ANALYZING A STACK WHEN IT GOT A STACK 
OVERFLOW. NO INDICATION OF THIS CONDITION WAS GIVEN TO THE USER. 
THIS PATCH CAUSES NOTIFICATION TO BE GIVEN. 


DodSt MCE a MissINe INTRINSICS: = 08-le-73 
IF AN INTRINSIC USED BY A CERTAIN PROGRAM IS MISSING, THE PROGRAM 
WILL BE DS-ED RATHER THAN GET A PROGRAM DUMP. 


DO437 MCP - D1 RELATIVE CODE BIT 43 ON - 08-12-73 

THIS FEATURE TREATS D1 RELATIVE CODE WHICH HAS BIT 43 ON IN ITS 
SEGMENT DESCRIPTOR AS IF IT WERE DO RELATIVE CODE FOR THE PURPOSE 
OF KANGAROO MANIPULATION. 


Dow? MoP = EVEN PARITY LABEL RECOGNITION - 95-19-73 

B5700 TAPES WITH EVEN PARITY LABELS WHOSE MFID IS ogoo00 WILL BE 
TREATED AS IF THEY HAD NO MFID. THIS IS FOR COMPATIBILITY WITH 
B3700 TAPES WHERE THAT LABEL IS INDICATIVE OF NO. MFID. 


DOYHS MCP -—-. RECONSTRUCTION MESSAGE - 09-23-73 page Wee 


DOYYS MCP —- RECONSTRUCTION MESSAGE - 09-23-73 


THIS PATCH sie: THE "RECONSTRUCTION IN PROCESS" MESSAGE TO BE 
DISPLAYED WHEN RECONSTRUCTING. 


DOY68 MCP - ADD FILETYPES 197,198 -—- 08-c6-73 


THIS CHANGE ADDS TWO FILETYPES 197 aes DATA), 198 (SEQUENCE 
CHARACTER DATA). 


DOY77 MCP - MEMORY DUMP IMPROVEMENTS - 08-19-73 


A MEMORY DUMP MAY NOW BE RESTARTED TO A NEW UNIT IF "CL" OR 
"RESTART" 1S ENTERED WHILE THE DUMP IS RUNNING. 


DOY85 MCP - CREATE USERCODE —- 09-04-73: 


FILE SECURITY AND SYSTEMS OPERATION: CHARACTERISTICS IMPOSE SOME 
RESTRICTIONS ON HOW THE CREATE VERB CAN BE USED TO CREATE A 
SCRAMBLED USERCODE DIRECTORY. 


1. USERCODE DIRECTORY MUST BE CREATED USING A PRIVILEGED 
USERCODE.. 


2. IF USERCODE FILES WERE IN USE, A  HALT/LOAD WILL BE 
REQUIRED TO CLEAR THE SYSTEM STORED POINTERS TO THE OLD 
USERCODE DIRECTORY BEFORE THE NEW WILL BE USED. . 


THE RECOMMENDED PROCEDURE FOR CREATING A SCRAMBLED DIRFCTORY FOR 
USERCODE IS , 


1. REMOVE PREVIOUS USERCODE IF NECESSARY AND HALT/LOAD. 
2. RUN CONTROL CARD AS FOLLOWS: 


DOY85 MCP - CREATE USERCODE - 09-04-73 nee Je 


USER PRIVILEGE; CREATE * USERCODE WITH 1e5 


PRIVILEGE IS ANY PRIVILEGED USERCODE. 1e5 IS ANY NUMERIC 
SCRAMBLE MODULUS. 


DORSS NCE” - SAU EVENT (SUNTax <2 ee 0722 
THE SYNTAX CHART FOR ADM INDICATES THAT, ON THE LOWEST PATH, THE 
WORD “EVENT” IS NOT REQUIRED. THIS IS INCORRECT; IT IS REQUIRED. 


DOWS7 MCP - LABEL ERROR ON DUMP TAPES - 09-09-73 

IF A MEMORY DUMP IS TAKEN ON A TAPE WITH A LABEL ERROR, THE TAPE IS 
SHOWN BY THE SYSTEM AS STILL HAVING THE LABEL ERROR WHEN THE DUMP 
IS COMPLETED. THIS IS DUE TO THE FACT THAT WHEN THE MCP. RECORDS 
THE STATUS OF THE TAPE WHEN IT IS FIRST BROUGHT ON-LINE, IT LOCKS 
THE UNIT ENTRY. THIS IN TURN IS DUE TO THE FACT THAT A LARGE 
AMOUNT OF TIME WOULD BE SPENT RETRYING THE TAPE EVERY TIME IT IS 
NECESSARY TO CHECK THE STATUS OF THE TAPE (E.G., AFTER A DUMP). 
THEREFORE, THE TAPE LABEL "“MEMORY/DUMP" WILL NOT BE FOUND WHEN THE 
MCP CHECKS TAPE STATUS AFTER THE DUMP. THE SOLUTION IS SIMPLY TO 
READY THE UNIT (EITHER WITH THE RY COMMAND OR SWITCHING THE DRIVE 
FROM REMOTE TO LOCAL AND BACK) WHEN THE DUMP IS TO BE ANALYZED. 


DO488 MCP — WORKSET IMPROVEMENT —- 05-19-73 


THIS PATCH INCLUDES THE FOLLOWING: 


Iss REDUCTION OF OVERHEAD OF WORKING SETS. 

2. CORRECTION OF A’ PROBLEM WHEREIN THE SYSTEM OVERLAYED AT 
LESS THAN THE SPECIFIED RATE. 

3. A CHANGE IN WHICH THE SYSTEM WILL ONLY WAKE UP THE HIGHEST 
SUSPENDED JOB. 


DOYWSY MCP - SHOW ACTIVE JOBS - 09-04-73 Bee ae 


DOus4 MCP - SHOW ACTIVE YOBS - 09-04-73 

A JOB WILL BE DISPLAYED IN THE "ACTIVE" SECTION IF IT DOES NOT HAVE 
ANY TASKS ASSOCIATED WITH IT. THUS WHILE A JOB IS EXECUTING ITS 
WFL INSTRUCTIONS IT WILL BE LISTED AS ACTIVE. 


DO520 MCP —- "NODUMP" SET IN MEMORY DUMP - 09-09-73 


THE COMMAND NODUMP MAY NOW BE TYPED AT THE CONSOLE WHILE MEMDUMP IS 
ACTIVE. THE EFFECT OF THIS COMMAND WILL BE TO SET OPTION 13 - 
(NODUMP) AFTER THE DUMP IS COMPLETE. THIS WILL PREVENT CERTAIN 
LOOPS WHEREIN AN ERROR IS DETECTED, A DUMP OCCURS AND THE ERROR IS 
DETECTED AGAIN WHEN THE: DUMP FINISHES OR IS DS-ED. 


pos22 MCP = ENABLE SHAPDISK ON PACK = 08-19-73 
THIS CHANGE MODIFIES THE INFORMATION IN DOO23 IN THE 2.3 SYSTEM 
MISCELLANEA. 


IN THE PAST SWAPPER HAS LOOKED ON HEAD-PER-TRACK DISK FOR A FILE 
CALLED SYSTEM/SWAPDISK. NOW SWAPPER WILL ALSO LOOK ON 
SYSTEMRESOURCE DISK PACK IF IT DID NOT FIND IT ON HEAD-PER-TRACK. 
THE FILE FORMAT IS THE SAME, REGARDLESS OF LOCATION. 


P aT 
NEW FEATURES AND DOCUMENTATION CHANGES oe ae 


eo 
poses = MCSIT == DELETION OF MCSII. ~ 09-04-73 
MCSII IS A SUBSET OF DIAGNOSTICMCS AND THEREFORE HAS BEEN DELETED 


FROM SYSTEM RELEASES. DIAGNOSTICMCS COMPILED WITH THE SOPTION 
NOANALYZER IS IDENTICAL TO MCSII. USERS WISHING TO RETAIN MCSII 
CAN CONTINUE TO USE THE SYMBOL AND OBJECT FROM THE 2.4 RELEASE AS 
NO CHANGES HAVE BEEN OR WILL BE MADE TO MCSII SINCE OR AFTER THE 
2.4 RELEASE. 


NEW FEATURES AND DOCUMENTATION CHANGES pace et 


NDL (NETWORK DEFINITION LANGUAGE) 


DOes NDE = INITIAL MESSAGE ALLOCATION - 05-07-73 

THIS PATCH CHANGES THE CALCULATION WHICH IS USED TO DETERMINE THE 
INITIAL AMOUNT. OF MESSAGE SPACE ALLOCATED FOR THE DCP. THIS NOW IS 
DONE AS FOLLOWS: 


he THE “SIZE OF MESSAGES ALLOCATED IS BASED ONLY UPON THE 
TERMINAL BUFFER AND TERMINAL MAXINPUT SIZES. EACH 
ALLOCATION IS MADE IN MULTIPLES OF 16 WORDS ONLY. THIS 
HELPS TO PREVENT CHECKER BOARDING. ONE OF THESE WORDS IS 
A LINK SO THE USABLE MESSAGE IS ONE WORD LESS THAN A 
MULTIPLE OF 16. 


2. A COUNT IS MAINTAINED FOR EACH REQUIRED SIZE. IT IS 
INCREMENTED ONCE FOR EACH TERMINAL WHICH REQUIRES THAT 
SIZE AND ONCE FOR’ EACH LINE WHOSE LARGEST REQUIREMENT 
BASED UPON ITS TERMINALS IS THAT SIZE. 


3. THIS COUNT IS ADJUSTED BY THE FOLLOWING FORMULA: 
COUNT : =SQRT (COUNT *2) 


THE INITIAL MESSAGE ALLOCATION FOR EACH SIZE MESSAGE IS 
THIS ADJUSTED COUNT. 


4. AN ADDITIONAL MESSAGE OF THE LARGEST SIZE IS ALLOCATED TO 
HELP PREVENT GETSPACE ABORTS. 


3S. A TABLE OF THESE ALLOCATIONS WILL BE PRINTED BY THE NDL 
COMPILER IF THE DOLLAR OPTION SUMMARY IS SET. 
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DO350 NOL - MCS DECLARATION - 06-24-73 


THE MCS DECLARATION HAS BEEN ADDED TO NDL. THE DECLARATION SHOULD 
APPEAR BEFORE THE STATION SECTION. THE SYNTAX IS: 


MCS <MCSID>:: 
CONTROL = <LOGICAL VALUE>. 


THIS ADDS THE <MCSID> TO THE LIST OF USABLE MCS"S. CONTROL = TRUE 
SPECIFIES EXTENDED RECONFIGURATION CAPABILITIES WHILE CONTROL = 
FALSE SPECIFIES NORMAL RECONFIGURATION ABILITIES. 


DOY“1e NDL —- INITIALIZE STATION VARIABLES - 07-26-73 


THIS. PATCH ALLOWS USERS TO INDICATE INITIAL VALUES FOR STATION 
TOGGLES AND TALLYS. THE SYNTAX FOR THIS STATION SECTION STATEMENT 
IS: 


<TOGGLE/TALLY INITIAL VALUE STATEMENT>: := 
INITIALIZE <TOGGLE/TALLY ASSIGNMENT LIST> 


<TOGGLE/TALLY ASSIGNMENT LIST>::= 
TALLYL< TALLY NUMBER> ]=<INTEGER>/TOG[<TOGGLE NUMBER> ]= 
<BOOLEAN PRIMARY>/<TOGGLE/TALLY ASSIGNMENT LIST>, 
TALLYT<TALLY NUMBER> ]=<INTEGERD>/<TOGGLE/TALLY ASSIGNMENT LIST>, 
TOGI<TOGGLE NUMBER>1]=<BOOLEAN PRIMARY> 


THE INITIALIZATION VALUE WILL BE ASSIGNED WHEN DCP INITIALIZATION 
OCCURS. 


DO4Y78 NDL - STATION ADDRESS PAIRS - 09-16-73 


IN SOURCENDL, WHEN DEFINING THE ADDRESS AS (DIFFERENT) IN THE 
TERMINAL SECTION, THE STATION ADDRESS COULD BE SPECIFIED AS A 
SINGLE ADDRESS AND BE DUPLICATED AUTOMATICALLY. THIS FEATURE DOES 
NOT WORK PROPERLY IN ALL CASES AND ALSO CAUSES CONFUSION. NDL NOW 
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GIVES AN ERROR. 


DOYSS NDL - SOFTWARE TRANSLATION - 05-07-73 


NDL NOW ALLOWS THE USER TO SPECIFY TRANSLATION TABLES IN SOURCENDL. 
THIS CONSTANT SECTION CONSTRUCT HAS THE FOLLOWING SYNTAX: 


<STRING TRANSLATION>::= <STRING> TO <STRING> 

<STRING TRANS GROUP>::= <STRING TRANSLATION>,<STRING TRANS GROUP> 
<STANDARD CODE>::= EBCDIC / ASC67 / BCL . 

<TRANSID>::= <IDENTIFIER> 


<STRINGSIZE>::= 1/727 3/74 /5/ 6/7/78 
<STANDARD CODE GROUP>::= <STANDARD CODE>TO<STANDARD CODE> 
<STRING TRANS TYPE>::= <STRING TRANS GROUP> /. <STANDARD CODE 

GROUP> / <TRANSID> 
<TRANSLATE STATEMENT>::= <TRANSID><STRINGSIZE>(<STRING TRANS TYPE>) 
<TRANSLATE STATEMENT GROUP>::= <TRANSLATE STATEMENT> / <TRANSLATE 

STATEMENT> ,<TRANSLATE STATEMENT 
GROUP > 


<TRANSLATE STATEMENT SECTION>::= TRANSLATETABLE <TRANSLATE 
STATEMENT GROUP > 


INVOCATION IS ACCOMPLISHED IN THE REQUEST SECTION BY: 


<TRANSLATION INVOCATION>::= <BYTE VARIABLE>=<TRANSID> (<BYTE 
VARIABLE >) 


TRANSLATION MUST BE FROM OR TO EBCDIC AND WHEN DEFINING ONE 
<TRANSID> IN TERMS OF ANOTHER, STRING SIZE MUST BE COMPATIBLE. FOR 
AN EXAMPLE SEE SYMBOL/SOURCENDL . 


DO4S6 NDL - BACKSPACE STATEMENT - 08-26-73 


THIS PATCH ALLOWS USERS TO BACKSPACE A’ TEXT BUFFER WHEN IN A 
RECEIVE REQUEST. THE SYNTAX FOR THE STATEMENT IS: 


A 4 
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<BACKSPACE STATEMENT>: := BACKSPACE 


, 00497 NDL - NDL ERROR DISPLAY - 05-07-73 


NDL NOK DISPLAYS AN “E" NEXT TO THE MIX NUMBER ON THE SYSTEM 
CONSOLE WHEN THE COMPILED JOB CONTAINS ERRORS. 


PAGE 175 
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OLDLISTDIRECTOR 


DOS41 OLDLISTDIR - OLDLISTDIRECTORY - 09-23-73 


A TEMPORARY PROGRAM, SYSTEM/OLDLISTDIRECTORY HAS BEEN RELEASED FOR 
ee 5. THIS PROGRAM MAY BE USED FOR CHECKING AND CONTRASTING WITH 
THE NEW LISTDIRECTORY. 


OLDLISTDIRECTORY IS BASICALLY THE 2.3 RELEASE OF LISTDIRECTORY WITH 
THE FOLLOWING UPDATES: IT NO LONGER HANDLES PRE-2@.2 DIRECTORY 
FORMATS, USER CONTROLLED PAGING IS IMPLEMENTED. IT PRODUCES TWO 
NEW REPORTS, THE CONDENSED DIRECTORY, WHICH CONSISTS OF ONLY THE 
DIRECTORY FILES IN HIERARCHICAL ORDER, AND A LIST OF FILE NUMBERS 
SORTED ON THE NUMBER OF SEGMENTS CONTROLLED BY THEM. 


“OLDLISTDIRECTORY DOES NOT HANDLE CRUNCHED FILES. AND HENCE FALSE. 
CONFLICT MESSAGES WILL PROBABLY OCCUR FOR CRUNCHED FILES. THE OLD 
METHOD OF OPENING DIRECTORIES IS USED AND HENCE THE PROGRAM IS MUCH 
SLOWER THAN LISTDIRECTORY. ALSO, OUTPUT FORMATS MAY DIFFER IN THE 
VARIOUS REPORTS. . . 


OLDLISTDIRECTORY WILL NOT BE MAINTAINED. 


NEW FEATURES, AND DOCUMENTATION CHANGES pone de 


PACKDIR 


DOs tEBCRDUR Cac TREX © BNO Bea D ING]. “2. 0o.c2. 
PACK INDEX NUMBERS FOR ALL ROWS ARE NOW CORRECT RATHER THAN ALWAYS | 
BEING THE BASE PACK. HEADINGS HAVE BEEN REFORMATTED TO REFLECT 
HEAD-PER-TRACK DISK OR DISK PACK OUTPUT. THE "CARRIAGE RETURN" 
CHARACTER (4 "0D") IS NOW ALLOWED IN THE INPUT PARAMETER STRING BUT 
IS DELETED DURING PROCESSING. HENCE, IT IS NEITHER A DELIMITER NOR 
A VISIBLE CHARACTER AND MAY BE USED IF THE INPUT STRING IS TOO LONG 
FOR ONE LINE. | 


THE DEFAULT PAGE SIZE FOR OUTPUT IS 81 LINES INCLUDING HEADINGS (CAT 
EIGHT LINES PER INCH) OR 58 LINES (AT SIX LINES PER INCH). THIS 
SIZE IS NOW CONTROLLED BY THE "PAGESIZE" ATTRIBUTE OF THE PRINTER 
FILE "LINE" AND MAY BE ALTERED AT.RUN TIME BY A FILE CARD. A 
"PAGESIZE" OF ZERO SETS THE LOGICAL PAGE TO 65,634. ~ 


ON PAGE 1-12 OF THE B6700 WORK FLOW MANAGEMENT USERS GUIDE 
(5000714), THE LINE, “FOR HPT, THE FIRST LEVEL IS IGNORED BUT MUST 
BE PRESENT" ‘SHOULD BE DELETED. 


DO4Y9e PACKDIR -— CRUNCHED FILE IDENTIFICATION — 10-16-73 


CRUNCHED FILES ARE NOW IDENTIFIED AS SUCH FOLLOWING THE FILE TYPE. 
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DOYg8 = PACKDIR — NEW APL AND BASIC FILETYPES - 08726773 
THIS PATCH ADDS THE FILETYPES APLDATA (195), APLWORKSPACE (196), 
CDATA (197) AND CSEQDATA (198) TO THE LIST OF KNOWN FILETYPES. 


DOS34  PACKDIR = INPUT HANDLING CHANGES = 09723773 

THIS PATCH CORRECTS INPUT HANDLING SUCH THAT LACK OF ANY FILE NAME 
DOES NOT CAUSE A SEGMENTED ARRAY ERROR TERMINATION. FOR USE WITH 
HEAD-PER-TRACK DISK, THE ABOVE CONDITION WILL RESULT IN REPORTING 
THE ENTIRE SYSTEM DISK. FOR DISK PACK, AN .ERROR MESSAGE WILL 
RESULT. ALSO, THE ENTIRE FILE IDENTIFIER FOR HEAD-PER-TRACK DISK 
IS NOW USED. PREVIOUSLY THE FIRST NAME WAS IGNORED. 


NEW FEATURES AND DOCUMENTATION CHANGES PAGE 178 


PATCH MAY NOW BE RUN FROM A TERMINAL USING CANDE. TWO NEW FEATURES 
HAVE BEEN ADDED TO MAKE USE FROM A TERMINAL FEASIBLE, THE $.DISK §$ 
<FILENAME> STATEMENT AND THE $.FILE STATEMENT. 


WHEN PATCH ENCOUNTERS A $.DISK CARD, IT INCLUDES THE CARDS FROM THE 
SPECIFIED FILE IN THE CURRENT PATCH, HOWEVER, IT IS ASSUMED THAT 
THE CARDS ALREADY CONTAIN MARK NUMBERS. THE NEW FEATURE ALLOWS A §$ 
BEFORE THE FILE NAME, IN WHICH CASE PATCH WILL ADD THE MARK NUMBERS 
TO THE CARDS. 


WHEN A $.FILE CARD IS ENCOUNTERED, ALL SUBSEQUENT CONTROL 
STATEMENTS WILL BE TAKEN FROM THE SPECIFIED FILE. THIS FEATURE 
OVERCOMES THE PROBLEM OF HAVING TO RE-ENTER THE CONTROL STATEMENTS 
EACH TIME PATCH IS RUN. 


etal eee 
RUN SYTEM/PATCH; FILE TAPE = SYMBOL/BACKUP © 
ENTER INPUTS 


$.RESET LIST SET COMPARE 
$.FILE CTRL 


FILE CTRL: 


$.MARK COMPILE 
_ S#PATCH OO1 

$.DISK $PATCHI 

$#PATCH 002 

$.DISK SPATCHe 

G# 

SSET NEW MERGE 


DO438 PATCH —- USE FROM CANDE TERMINAL —- O7-14-73 Pia, pes 


THE &.DISK $<FILENAME> CARD MAY ALSO BE USED WHEN RUNNING PATCH 
THROUGH THE CARD READER; HOWEVER, NO SEQUENCE CHECKING, $ CARD OR 
CONTROL CARD PROCESSING WILL BE DONE ON THE CARDS FROM THE FILE. 


NEW FEATURES AND DOCUMENTATION CHANGES PAGE 180 


PLI 


DO4U33 PLI - ONCODES FOR CONDITIONS -—- 09-23-73 


THE ONCODE BUILTIN FUNCTION MAY BE USED BY THE PROGRAMMER WITHIN AN 
ON-UNIT TO DETERMINE THE NATURE OF HIS ERROR WHEN A CONDITION IS 
RAISED. THE INITIAL LIST OF THESE ONCODES FOLLOWS UNDER THE ON 
CONDITION TO WHICH IT APPLIES: 


IMPLEMENT 
601 EXCLUSIVE FILE OPTIONS ARE NOT IMPLEMENTED. 
602 THIS RECORD 1/70 OPTION IS NOT IMPLEMENTED. 
603 COMPLEX OPERATIONS ARE NOT IMPLEMENTED. 
604 UNIMPLEMENTED CONVERSION. 


801 END-OF-FILE OCCURRED WHILE PROCESSING GET STATEMENT. 

80e END-OF-FILE OCCURRED WHILE PROCESSING PUT STATEMENT. 

807 END-OF-FILE OCCURRED WHILE PROCESSING GET STRING 
STATEMENT. 

808 END-OF-FILE ODDURRED WHILE PROCESSING PUT STRING 
STATEMENT. 

809 END-OF-FILE OCCURRED ON A KEYED FILE I/O. 


ENDPAGE 


- 902 END-OF-PAGE OCCURRED WHILE PROCESSING PUT STATEMENT. 


1301 UNDEFINED I/0 RESULT WORD ERROR ON OUTPUT. 
1302 UNDEFINED I/0 RESULT WORD ERROR ON INPUT. 
1303 RESULT DESCRIPTOR ERROR ON KEYED I/O. 
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D043 PLI_ - ONCODES FOR CONDITIONS = 9-23-73 TN°* 

1404 RESULT DESCRIPTOR ERROR ON KEYED READ. 

1405 RESULT DESCRIPTOR ERROR ON KEYED WRITE. 

1306 RESULT DESCRIPTOR ERROR ON KEYED TABLE READ. 

1307 RESULT DESCRIPTOR ERROR ON KEYED TABLE WRITE. 

NAME 

1401 UNRECOGNIZED IDENTIFIER IN THE INPUT OR AN IDENTIFIER 
NOT IN THE ASSOCIATED INPUT LIST. ON A_ GET DATA 
STATEMENT. 

RECORD 

1501 PHYSICAL RECORD SIZE DIFFERS FROM FILE RECORD SIZE 
SPECIFICATION ON RECORD 1/0 INTO OR FROM FIXED STRING. 

1502 FILE RECORD SIZE EXCEEDS LENGTH OF VARYING STRING ON 

RECORD READ INTO VARYING STRING. . 

1503 LENGTH OF VARYING STRING EXCEEDS FILE RECORD SIZE ON 
RECORD WRITE FROM VARYING STRING. © 

SIZE 

1601 ERROR IN PROCESSING F FORMAT ITEM FOR A GET EDIT 
STATEMENT. NUMBER OF DECIMAL DIGITS SPECIFIED IS 
GREATER THAN THE FORMAT FIELD WIDTH. 

160e ERROR IN PROCESSING F- FORMAT ITEM FOR A PUT EDIT 
STATEMENT. THE WIDTH OF THE NUMBER IS GREATER THAN 
FORMAT FIELD WIDTH. 

1603 ERROR IN PROCESSING F FORMAT ITEM FOR A PUT EDIT 
STATEMENT. MORE DECIMAL DIGITS ARE SPECIFIED THAN © 
SIGNIFICANT DIGITS. 

1604 ERROR IN PROCESSING E FORMAT ITEM FOR A PUT EDIT 
STATEMENT. MORE DECIMAL DIGITS ARE SPECIFIED THEN 
SIGNIFICANT DIGITS. , 

1605 SIZE CONDITION ERROR IN ASSIGNING REAL TO REAL. 

1606 SIZE ERROR OCCURRED WHEN ASSIGNING TO A BINARY FIXED 
OPERAND. 

1607 SIZE ERROR OCCURRED WHEN ASSIGNING TO A DECIMAL FIXED 
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OPERAND. 
1608 THE SOURCE BITSTRING IN A’ STRING TO ARITHMETIC 
CONVERSION IS LONGER THAN 39 BITS. 
1609 THE SOURCE BITSTRING IN A’ STRING *O ARITHMETIC 
CONVERSION IS LONGER THAN 78 BITS. 


1701 ALLOCATE ERROR - ALLOCATE OF NEGATIVE SIZE REQUESTED. 
1702 FREE ERROR - .CHUNK IS ALREADY FREE. 

1703 TANK AREA FOR LOCAL ARRAYS IS EXHAUSTED. 

1704 ALLOCATE ERROR - AREA IS EXHAUSTED. 

1705 FREE ERROR - NO SUCH CHUNK EXISTS. 

1708 FREE ERROR - INVALID FREE STACKED. 

1709 ALLOCATE ERROR - INVALID AREA HEADER. 

1710 FREE ERROR - INVALID AREA HEADER. 

1711 FREE ERROR - INVALID CHUNK WORD. 


1801 SOURCE STRING IS LONGER THAN’ TARGET STRING IN BIT 
STRING TO CHARACTER STRING CONVERSION. 

1802 SOURCE STRING IS LONGER THAN TARGET STRING’ IN 
CHARACTER STRING TO BIT STRING CONVERSION. 

1803 SOURCE STRING IS LONGER THAN’ TARGET STRING IN BIT 
STRING TO BIT STRING CONVERSION. 

1804 SOURCE STRING IS LONGER THAN TARGET .STRING IN 
CHARACTER STRING TO CHARACTER STRING CONVERION. 

1805 SOURCE CHARACTER STRING IS LONGER THAN DESTINATION 
CHARACTER STRING. 

1806 SOURCE BIT STRING IS LONGER) THAN DESTINATION BIT 
STRING. . 


1901 STRINGRANGE ERROR IN EVALUATION OF SUBSTR BUILT. IN 
FUNCTION. 


DOYS 


3 PLI - ONCODES FOR CONDITIONS = DO-eS-75 ee 


ILLEGAL BINARY CHARACTER ENCOUNTERED IN CHARACTER 
STRING TO BIT STRING CONVERSION. — 

ILLEGAL BINARY CHARACTER ENCOUNTERED IN BIT STRING TO 
ARITHMETIC CONVERSION. 

A "+" OR "=" SIGN APPEARS AFTER A COMPLEX NUMBER. 
ILLEGAL BINARY CHARACTER ENCOUNTERED IN CONVERSION TO 
ARITHMETIC IN A GET STATEMENT. 

ILLEGAL CHARACTER ENCOUNTERED IN CONVERSION TO 
ARITHMETIC IN A GET STATEMENT. 

ERROR IN STRING TO ARITHMETIC CONVERSION. 

MISSING OR ILLEGAL CONSTANT IN CHARACTER STRING TO 
ARITHMETIC CONVERSION. 

MISSING EXPONENT FOLLOWING "“E" IN FLOATING POINT 
NUMBER. 

MISSING "I" FOLLOWING COMPLEX NUMBER. 

ILLEGAL ALPHANUMERIC CHARACTER IN PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

ILLEGAL NUMERIC CHARACTER IN PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

MISSING "+" OR "=" SIGN ON PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

MISSING "$" SYMBOL OR INSERTION CHARACTER IN PICTURE 
VARIABLE TO CHARACTER STRING CONVERSION. 

MISSING INSERTION CHARACTER IN PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

ILLEGAL FLOAT CHARACTER FOUND IN PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

MISSING FLOAT CHARACTER IN PICTURE VARIABLE TO 
CHARACTER STRING CONVERSION. 

ILLEGAL NUMERIC CHARACTER IN CHARACTER STRING TO 
PICTURE VARIABLE CONVERSION. 

ILLEGAL ALPHANUMERIC CHARACTER IN CHARACTER STRING TO 
PICTURE VARIABLE CONVERSION. 
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DO433  PLI_ = ONCODES FOR CONDITIONS - 09-23-73 
KEY 

2401 NO RECORD WAS FOUND WITH THIS KEY. 

e40e NO SPACE IS AVAILABLE FOR ADDITIONAL KEYED RECORDS. 

2403 ATTEMPTED TO WRITE A DUPLICATE KEYED RECORD WITH THE 
"NO DUPLICATE" OPTION SET. 

2404 A DUPLICATE KEYED RECORD WAS ADDED WITH "RETAIN 
DUPLICATES" OPTION SET. 

2405 A DIFFERENCE IN KEY EXISTS ON A REWRITE STATEMENT. 

2406 A KEY ERROR EXISTS ON A "CREATE" WRITE. E.G., THE 
KEYS ARE OUT OF ORDER. 

2407 TABLE OVERFLOW ON A KEYED "CREATE" WRITE. 

2408 A REWRITE WAS ATTEMPTED BEFORE A READ WAS EXECUTED. 

2409 INVALID USAGE OF KEYED FILE OR KEYED OPTION. 


UNDEF INEDF ILE 


ATTRIBUTE CONFLICT ON THIS FILE. 

ILLEGAL FILE ACCESS METHOD. 

IMPLICIT OPEN FAILURE. 

ATTEMPTED TO CLOSE AN UNOPENED FILE. 
PARAMETER ERROR ON KEYED FILE OPEN. 

KEYED FILE OPENED INCORRECTLY. 

ERROR OCCURRED WHILE OPENING A KEYED FILE. 
CANNOT HANDLE A BCL FILE. 


AN ATTEMPT WAS MADE TO ACCESS AN UNINITIALIZED 
VARIABLE . 

UNIMPLEMENTED OR UNSUPPORTED FORMAT PHRASE. 

FORMAT ERROR, MISSING LEFT PARENTHESIS. 

SQRT ERROR. 

PICTURE CONVERSION ERROR WAS NOT CORRECTED.» 

DOUBLE SQRT ERROR. 

STRING TO ARITHMETIC CONVERSION ERROR WAS NOT 
CORRECTED. 
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2608 STRING TO STRING CONVERSION ERROR WAS NOT CORRECTED. 


DO4S3 PLI - BINDING DOUBLES — 10- 16-73 


THIS PATCH IMPLEMENTS BINDING DOUBLES. 


pous9- PLI. - FILE DECLARATION - 05-07-73 

‘THE SYSTEM FILE ATTRIBUTE MYUSE WILL BE SET TO "OUT" IF THE 
LANGUAGE FILE ATTRIBUTE OUTPUT OR PRINT IS SPECIF IED OR IF IT IS 
THE SYSPRINT FILE. : 


THE SYSTEM FILE ATTRIBUTE MYUSE WILL BE SET TO "IN" IF THE LANGUAGE 
FILE ATTRIBUTE INPUT IS SPECIFIED OR IF IT IS THE SYSIN FILE. 


IF THE LANGUAGE FILE ATTRIBUTE PRINT IS SET OR KIND IS SET TO 
PRINTER OR THE FILE IS A SYSPRINT FILE PAGESIZE WILL HAVE A DEFAULT 
SIZE OF 58. 


THE DEFAULT SAVE FACTOR FOR A FILE HAS BEEN CHANGED FROM ONE TO 30. 


DBOSOO PLAS <= FILE VARIABLE - O5- 07- -73 


FILE VARIABLES, FILE PARAMETERS, AND INTERNAL FILES ARE NOW 
IMPLEMENTED. . . 


PLEASE REFER TO PL/I DOCUMENT (5000201) FOR FULL EXPLANATION OF 
FILE VARIABLES. 


DO5O1 PLI - OPTIONS IN OPEN STATEMENT - 05-07-73 


BITSTREAM AND BL INESIZE ARE NO LONGER RECOGNIZED AS VALID OPTIONS 
IN THE OPEN STATEMENT. 
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GENERAL FORMAT: 
<OPEN-STATEMENT>::= OPEN<OPTIONS-GROUP>{ ,<OPTIONS GROUP>]...; 
<OPTIONS-GROUP>: : = 

FILE(<FILE DESIGNATOR>) 

[TITLE (FILE-TITLE) ] 

[ENVIRONMENT (<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION-LISTD) ] 

(OPTIONS (<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION-LIST)>)] 

[PRINT] 

[INPUT / OUTPUT / UPDATE] 

(STREAM / RECORD) 

C[LINESIZE (<SCALAR-EXPRESSION>) ] 

[PAGESIZE (<SCALAR-EXPRESSIOND) ] 

[INDENT (<SCALAR-EXPRESION>) ] 

[ VOLUME J 

[EXCLUSIVE] 

[ BACKWARDS ] 

{ TRANSIENT] 

[SEQUENTIAL / DIRECT] 

[TAB(<SCALAR-EXPRESSION LIST>)] 


<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION-LIST>: := 
<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION> / 
<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION-LISTD>, 
<SYSTEM-F ILE-ATTRIBUTE-SPECIF ICATION> 


<SYSTEM-F ILE-ATTRIBUTE-SPECIFICATION>: := 
<SYSTEM-F ILE-ATTRIBUTE >=<SCALAR-EXPRESSION> / 
<BOOLEAN-VALUED-SYSTEM-F ILE-ATTRIBUTE> 


FUNCTION: 


THE OPEN STATEMENT COMPLETES THE SPECIFICATION OF ATTRIBUTES FOR 
THE FILE AND EXPLICITLY OPENS THE FILE, IF THE FILE HAS NOT 
PREVIOUSLY BEEN OPENED. IF THE FILE HAS ALREADY BEEN OPENED THE 
STATEMENT IS IGNORED. ATTRIBUTE SPECIFICATIONS IN THE OPEN 
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STATEMENT TAKE PRECEDENCE OVER ATTRIBUTE SPECIFICATIONS IN THE FILE 
DECLARATION. 


GENERAL RULES: 

1. THE FOLLOWING LANGUAGE FILE ATTRIBUTES ARE NOT IMPLEMENTED 
AND ATTEMPTING TO SPECIFY THEM IN AN OPEN STATEMENT WILL 
GENERATE AN ERROR OF LEVEL SIX AND THE SPECIFICATION, WILL 
BE IGNORED. , 


INDENT VOLUME EXCLUSIVE BACKWARDS TRANSIENT 


2: IF THE FILE HAS ALREADY BEEN OPENED THE OPEN STATEMENT 
WILL BE IGNORED. 


3. ATTEMPTING TO SET CONFLICTING LANGUAGE FILE ATTRIBUTES 
WILL GENERATE A SYNTAX ERROR OF LEVEL THREE. FOR A LIST 
OF COMPATIBLE LANGUAGE FILE ATTRIBUTES SEE SYSTEM NOTE 
DOeed5. 


4. ATTEMPTING TO SET A SYSTEM FILE ATTRIBUTE INSIDE THE 
ENVIRONMENT OR OPTIONS CLAUSE THAT CONFLICTS WITH A 
LANGUAGE FILE ATTRIBUTE WILL GENERATE A LEVEL THREE SYNTAX 
ERROR AND THE SPECIFICATION INSIDE THE ENVIRONMENT OR 
OPTIONS CLAUSE WILL BE IGNORED. PL/I LANGUAGE FILE 
ATTRIBUTES AND SYSTEM FILE ATTRIBUTES THAT CONFLICT ARE: 


LANGUAGE FILE ATTRIBUTE = SYSTEM FILE ATTRIBUTE 
PRINT KIND 
TITLE TITLE 
PAGESIZE PAGESIZE 
INPUT , OUTPUT , UPDATE MYUSE 


5. CURRENT SYNTAX FOR KIND WILL STILL BE RECOGNIZED. 


6. SYNTAX FOR SETTING SYSTEM FILE ATTRIBUTES INSIDE THE 
OPTIONS OR ENVIRONMENT CLAUSE IN AN OPEN STATEMENT IS THE 
SAME AS FOR A FILE DECLARATION EXCEPT THAT THE 
SPECIFICATIONS NEED NOT BE CONSTANT. IN THE CASE OF 
SYSTEM FILE ATTRIBUTES THAT REQUIRE MNEMONICS THEY MUST BE 
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USED. THIS CAN BE DONE BY SPECIFYING A STRING CONSTANT OR 
A STRING VARIABLE WHICH HAS BEEN ASSIGNED THE CORRECT 
VALUE. IF A CONSTANT IS USED A COMPILE TIME CHECK IS MADE 
TO SEE IF IT IS A VALID MNEMONIC FOR THE SPECIFIED FILE 
ATTRIBUTE. IF NOT AN ERROR OF LEVEL THREE IS GIVEN. IF A 
VARIABLE IS USED IT IS CHECKED AT RUN TIME AND IF IT IS AN 
INVALID MNEMONIC A NON-FATAL RUN TIME ERROR IS GIVEN. FOR 
A LIST OF SYSTEM FILE ATTRIBUTES AND SYSTEM FILE ATTRIBUTE 
MNEMONICS SEE PL/I FILE DECLARATIONS DO2e5. 


6. ATTEMPTING TO SET INTMODE INSIDE THE ENVIRONMENT OR 
OPTIONS CLAUSE WILL CAUSE AN ERROR OF LEVEL ZERO TO BE 
GENERATED AND THE SPECIFICATION WILL BE IGNORED. 


7. ATTEMPTING TO SET A READ-ONLY ATTRIBUTE INSIDE THE 
ENVIRONMENT OR OPTIONS CLAUSE WILL CAUSE AN ERROR OF LEVEL 
THREE TO BE GENERATED AND THE SPECIFICATION WILL BE 
IGNORED. 


DOS503 PLI —- RECORD CONDITION - 05-19- ~73 


THE RAISING AND HANDLING OF THE RECORD CONDITION IS NOW IMPLEMENTED. 
PLEASE REFER TO THE PL/I DOCUMENT (5000201) FOR DETAILED 
DESCRIPTION. . 


DO504 PLI - FILE ATTRIBUTE ASSIGN AND REF - 06-24-73 


FUNCTION: 


THE SYSTEM FILE ATTRIBUTE ASSIGNMENT STATEMENT IS USED TO SET THE 
VALUE OF A SYSTEM FILE ATTRIBUTE FOR A FILE OUTSIDE OF A FILE 
DECLARATION OR AN OPEN STATEMENT. 


GENERAL FORMAT: 


DOSO4Y PLI - FILE ATTRIBUTE ASSIGN AND REF - O6-24-7 
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<SYSTEM FILE ATTRIBUTE>(<FILE DESIGNATOR>) = <SCALAR EXPRESSION> 


GENERAL RULES: 


1 


A WARNING OF LEVEL ZERO WILL BE GENERATED IF AN ATTEMPT IS 
MADE TO SET INTMODE AND THE STATEMENT WILL BE IGNORED. 


AN ERROR OF LEVEL THREE WILL BE GENERATED IF AN ATTEMPT IS 
MADE TO SET A READ-ONLY ATTRIBUTE AND THE STATEMENT WILL 
BE IGNORED. 


MULTIPLE ASSIGNMENTS ARE NOT ALLOWED.° 


IF THE SYSTEM FILE ATTRIBUTE TITLE OR INTNAME IS SPECIFIED 
A PERIOD WILL BE INSERTED AT THE END OF THE STRING. 


IF A FILE ATTRIBUTE HAS MNEMONICS THEY MUST BE USED. THIS 
CAN BE DONE BY SPECIFYING A STRING CONSTANT OR A STRING 
VARIABLE WHICH HAS BEEN ASSIGNED THE CORRECT VALUE. IF A 
CONSTANT IS USED A COMPILE TIME CHECK IS MADE TO SEE IF IT 
IS A VALID MNEMONIC FOR THE SPECIFIED FILE ATTRIBUTE. IF 
NOT AN. ERROR OF LEVEL THREE IS GIVEN. IF A VARIABLE IS 
USED IT IS CHECKED AT RUN TIME AND IF IT IS AN INVALID 
MNEMONIC A NON-FATAL RUN TIME ERROR IS GIVEN. _ 


SYSTEM FILE ATTRIBUTE REFERENCE STATEMENT 


FUNCTION: 


THE SYSTEM FILE ATTRIBUTE REFERENCE STATEMENT IS USED TO REFERENCE 


THE VALUE OF A SYSTEM FILE ATTRIBUTE. 


GENERAL FORMAT: 


<SCALAR VARIABLE> = <SYSTEM FILE ATTRIBUTE>(<FILE DESIGNATOR>) 


<PSEUDO VARIABLE > 


<SYSTEM FILE ATTRIBUTE>(<FILE DESIGNATOR>) 


GENERAL RULES: 


Tig 


A CHECK IS MADE FOR A’ SYSTEM FILE ATTRIBUTE BEFORE 
CHECKING FOR A’ USER INTRINSIC I.E. A USER INTRINSIC OF 
THE SAME NAME AS A SYSTEM FILE ATTRIBUTE WILL NO LONGER BE 


DOSOY PLI - FILE ATTRIBUTE ASSIGN AND REF - O06-24- ade ne 


RECOGNIZED. 


e. AN ERROR OF LEVEL THREE WILL BE GIVEN IF AN ATTEMPT IS 
MADE TO REFERENCE A WRITE-ONLY SYSTEM FILE ATTRIBUTE. 


Dose). “ELI” - = PRE ZPROCESSOR DO-STATEMENT = 067e4=73 

THE PRE-PROCESSOR DO STATEMENTS ARE IMPLEMENTED. PLEASE REFER TO 
THE PL/I DOCUMENT (5000201) FOR DETAILED DESCRIPTION OF THIS 
FEATURE. 


guage DEE AUTOR IND’, Ur incds 
THIS PATCH SETS THE "“AUTOBIND" OPTION ON PL/I COMPILATIONS TO 
FACILITATE FASTER SEPCOMP COMPILATIONS. 


DOSO7 = PLI = LINECNT OPTION = 07-14-73: 

THIS PATCH IMPLEMENTS A NEW COMPILER CONTROL OPTION: "SET LINECNT = 
N", WHERE N IS THE NUMBER OF LINES PER PAGE ON COMPILATION LISTINGS. 
FOR EXAMPLE, ON SIX LPI PRINTERS, THE OPTION MIGHT BE "SET LINECNT . 
= 58". 


posds PLT = PRETPROCESSOR PROCEDURES & BIF - 07-14-73 
PRE-PROCESSOR PROCEDURES ARE NOW IMPLEMENTED. A "XDCL P ENTRY; 
STATEMENT IS SUFFICIENT TO DECLARE PROCEDURES WITH ANY NUMBER OF 
PARAMETERS AND ANY RETURN. PROCEDURES MAY BE CALLED RECURSIVELY. 
THEY MAY NOT BE NESTED MORE THAN 48 DEEP. ALL PRE-PROCESSOR 
VARIABLES MUST NOW BE DECLARED BEFORE BEING RECOGNIZED AS PRE- 
PROCESSOR VARIABI ES. 


THIS PATCH ALSO IMPLEMENTS SUBSTR, LENGTH AND INDEX IN PRE- 


0508 PLI - PRE-PROCESSOR PROCEDURES & BIF - 07-14-73°°F 1°! 


PROCESSOR. PLEASE REFER TO PL/I DOCUMENT (5000201) FOR A DETAILED 
DESCRIPTION OF THESE LANGUAGE FEATURES. 


DOSOS PLI  —- DUMP STATEMENT =(07=es=73 


THE DUMP STATEMENT IS NOW IMPLEMENTED IN PL/I. 
FUNCTION: . 


THE DUMP STATEMENT ACTIVATES AN INTRINSIC WHICH PRODUCES A PROGRAM 
STACK DUMP. WHEN THE PROGRAM STACK DUMP HAS BEEN COMPLETED, 
CONTROL PASSES TO THE NEXT EXECUTABLE STATEMENT. 


GENERAL FORMAT: 
<DUMP-STATEMENT> : := DUMP / DUMP (<DUMP-OPTION-LIST>) 


<DUMP-OPTION-LIST>::= <DUMP-OPTION> / <DUMP-OPTION-LIST> 
<DUMP-OPTION>::= CODE / BASE / FILE / FILES / ARRAY / ARRAYS / ALL 


GENERAL RULES: 


1. IF NO DUMP OPTIONS ARE SPECIFIED IN THE DUMP STATEMENT, 
THE DUMP OPTIONS SPECIFIED IN THE OPTIONS SYSTEM CONTROL 
CARD WILL BE USED. IF THERE IS NO OPTIONS SYSTEM CONTROL 
CARD THE DEFAULT WILL APPLY. 


DO510 PLI - STRING COMPARE IN PRE-PROCESS -—- 08-c6-73 


THIS PATCH IMPLEMENTS STRING COMPARES IN PRE-PROCESSOR. 


DO535 PLI - KEYED i= OD? «= O77 14= =1S 


THE KEYED 1/0, UPDATE I/O AND INDEXED SEQUENTIAL 1/0 FEATURES OF 
PL/I HAVE BEEN IMPLEMENTED. 


THESE FEATURES ALLOW: 
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DIRECT KEYED READS 

ADDING OF KEYED RECORDS 

READING OF NEXT KEYED RECORD IN SEQUENCE 
REWRITING KEYED RECORD JUST READ 
OVERWRITING A KEYED RECORD 

6. DELETING KEYED RECORDS 


of Wh 


CISAM READ) 


KEYED FILES MAY BE ORDERED IN ASCENDING OR DESCENDING SEQUENCE. 


RECORDS MAY BE PHYSICALLY OR LOGICALLY DELETED. 


DUPLICATE KEYS MAY 


BE OPTIONALLY ALLOWED. A VARIETY OF KEY TYPES ARE ALLOWED. 


A USER DECLARES A KEYED FILE BY: 


1. DECLARING THE FILE TO HAVE THE "KEYED" AND/OR "DIRECT" 


ATTRIBUTE. 


2. SPECIFYING THE FILE ATTRIBUTES AREAS AND AREASIZE, WHICH © 


WILL DEFINE THE PRIME DATA AREA. 


3. SPECIFYING THE DESIRED KEYED OPTIONS IN TABLE ONE . 


TABLE 1 
KEYED OPTION FUNCTION 
KEYLENGTH LENGTH OF KEY IN 8-BIT 
. BYTES 
KEYSTART STARTING BYTE NUMBER 


C(1-RELATIVE OF THE KEY 
EMBEDDED IN THE RECORD) ; 
IF ZERO, THE KEY IS NOT 
PART OF THE RECORD 
KEYORDER SEQUENCE OF KEYS: 
ASCENDING OR DESCENDING; 
DEFAULT IS ASCENDING 


SYNTAX 


KEYLENGTH =. 
<CONST .ARITH.EXP> 


_KEYSTART = 


<CONST.ARITH.EXP> 


KEYORDER = 
<-ASCENDING-> OR 
<-DESCEND I NG-> 
NOTE: DASH (-) 
IS USED AS SINGLE 
QUOTE. 
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DO535 PLI - KEYED I-O —- 07-14-73 
KEYED OPTION FUNCT ION SYNTAX 
F ILEOVERFLOW THE NUMBER OF AREAS FILEOVERFLOW = 
ALLOCATED FOR THE <CONST. ARITH.EXP> 


RECORDS FOR AREA 
ALLOCATED FOR OVERFLOW 
SPACE; DEFAULT IS ZERO 

KEYSPERENTRY THE "FINENESS" OF THE FINE KEYSPERENTRY. 
TABLE, I.£., THE NUMBER <CONST.ARITH.EXP> 
OF RECORDS REPRESENTED BY 
ONE FINE TABLE ENTRY; 

DEFAULT: 1S ONE 

NODUPL ICATES IF SPECIFIED, DUPLICATE _ NODUPLICATES 

KEYED RECORDS ARE ERRORS, 
OTHERWISE THEY ARE ALLOWED 
IN A “FIRST-IN-FIRST-OUT" 

BASIS; 

SAVEDELET IONS IF SPECIFIED, DELETED SAVEDELETIONS 
RECORDS ARE "LOGICALLY 
DELETED", BUT ARE 
AVAILABLE ON SEQUENTIAL 
READS. THE FIRST BYTE OF 
THE RECORD WILL BE FLAGGED 
WITH A 4Y"FF", INDICATING 
DELETION. THE TABLE 
ENTRY IS REMOVED AND THE 
RECORD IS "SEEN" ONLY ON 
SEQUENTIAL READS. : 

KEYTYPE MODE OF THE KEY. KEYTYPE=0 
O=BINARY 
1=8-BIT CHARACTERS - 
2=8-BIT UNSIGNED NUMERIC 
3=8-BIT MSD SIGNED NUMERIC 
(SIGN IN ZONE OF MOST 
SIGNIFICANT BYTE) 
4=8-BIT LSD SIGNED NUMERIC 
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KEYED OPTION FUNCT ION SYNTAX 


9=4-BIT CHARACTERS 

6=4-BIT UNSIGNED NUMERIC 
7=4-BIT MSD SIGNED NUMERIC 
8=4-BIT LSD SIGNED NUMERIC 
(DEFAULT IS ONE (8-BIT 
CHARACTERS) 


KEYLENGTH AND KEYSTART ARE THE ONLY REQUIRED KEYED OPTIONS. 


A USER MAY "REWIND" THE KEYED FILE AND READ THE FIRST RECORD BY 
PERFORMING A READ-KEY, WITH A KEY OF ALL ZEROES. THE LOW BUILTIN 
FUNCTION MAY BE USED FOR THIS SPECIAL KEY. 


KEYED OPTIONS MAY NOT APPEAR AS OPEN STATEMENT OPTIONS, FILE 
ATTRIBUTE ASSIGNMENTS OR BE LABEL EQUATED. 


“EXAMPLES: 


DECLARE K FILE KEYED ENVIRONMENT (KEYLENGTH=4,KEYSTART=1 ,AREAS=2, 
AREASIZE=10); 
DECLARE KY FILE DIRECT KEYED 
ENVIRONMENT (AREAS=10,AREASIZE=15, 

KE YORDER=-DESCENDING- , KEYSPERENTRY=4, 
FILEOQVERFLOW=4 , AREAOVERFLOW=2, 
NODUPLICATES,SAVEDELETIONS, 
KEYLENGTH=10,KEYSTART=0) ; 


NOTE: THE DASH (-) HAS BEEN USED AS THE SINGLE QUOTE. 


THE FOLLOWING 1/0 STATEMENTS ARE NOW IMPLEMENTED AND BE USED TO 
MANIPULATE A KEYED FILE: 


READ FILE (<FILE-EXP>) INTO( VARIABLE) 3 

READ FILE (<FILE-EXP>) INTO(VARIABLE) KEY(<SCALAR-EXP>) ; 

READ FILE (<FILE-EXP>) INTO(VARIABLE) KEYTO(<SCALAR-REF>) ; 

READ FILE (<FILE-EXP>) SET (SCALAR-PTR-VAR) 

READ FILE (<FILE-EXP>) SET (<SCALAR-PTR-VAR>) KEY (<SCALAR-EXP>) ; 
READ FILE (<FILE-EXP>)SET(<SCALAR-PTR- VAR>)KEYTO(<SCALAR-EXP>) ; 


D0535 PEL = KEYED 1-0) -=°07-[4=73 a 


WRITE PFE (AE TLESEXO> FROM OVARI ABLEYKEVEROM(<SCAUARZEXPS 1s 
DELETE FILE(<FILE-EXP>) [KEY (<SCALAR-EXP>) 1]; 
REWRITE FILE(<FILE-EXP>) [KEY<SCALAR-EXP> IFROM(VARIABLE) ; 


LOCATE FILE(<FILE-EXP>) [SET (<SCALAR-PTR-VAR>) JKEYFROM 
(<SCALAR-EXP>) ; 


BY USING THE WRITE-KEYFROM STATEMENT, A KEYED FILE MAY BE CREATED, 
IN ASCENDING OR DESCENDING SEQUENCE . 


THE FILE MAY BE READ DIRECTLY (READ-KEY STATEMENT) OR SEQUENTIALLY 
(READ-INTO, READ-SET). 


BY OPENING THE FILE UPDATE, RECORDS MAY BE ADDED (WRITE-KEYFROM), 
DELETED (DELETE STATEMENT) OR OVERWRITTEN (REWRITE-KEY STATEMENT). 
ADDITIONALLY, LOCATE-MODE 1/0 MAY BE’ PERFORMED ON A KEYED FILE 
(LOCATE-KEYFROM, READ-SET). 


ALL KEYS ARE PASSED TO THE KEYED INTRINSICS AS B6700 HARDWARE 
POINTERS WITH AN ASSOCIATED 8-BIT CHARACTER LENGTH. HENCE, A 
BINARY KEY IS PASSED WITH A LENGTH OF SIX (ONE WORD), A PIC 
“HHHHHS" IS PASSED WITH A LENGTH OF THREE AND CHARACTER(S0) IS 
PASSED AS 50. 


IF ABNORMAL ERRORS ARISE DURING FILE CREATION OR ACCESS, THE KEY 
CONDITION WILL BE RAISED, AND THE BUILT-IN ONCODE WILL PROVIDE THE 
ERROR CODE . . 


VARIABLE LENGTH RECORDS ARE NOT ALLOWED FOR KEYED FILES. 


SEE 


A DOCUMENT DESCRIBING THE DESIGN AND DETAILED USE OF THE KEYED 1/0 
INTRINSICS, IS AVAILABLE ON REQUEST FROM THE LARGE SYSTEMS PLANT, 


CITY OF INDUSTRY, CALIFORNIA. 
a  ————— 


D0536 PLI - FORMAT VARIABLES - O8- ioe 73 


oe ee — aime: _— ee ee Oa ee ee —ee eee 


THE FORMAT ATTRIBUTE AND FORMAT VARIABLES ARE NOW IMPLEMENTED. 


THE FORMAT ATTRIBUTE IS A PROGRAM CONTROL ATTRIBUTE WHICH SPECIFIES 
THAT THE IDENTIFIER WILL HAVE FORMAT-CONSTANTS -AS. VALUES. 


DO536. «= PLI - FORMAT VARIABLES - 08-12-73 PAGE: te 


THE FORMAT VARIABLE MAY HAVE OTHER FORMAT VARIABLES OR FORMAT 
CONSTANTS ASSIGNED TO IT. WHEN THE ASSIGNMENT IS MADE, THE 
ENVIRONMENT OF THE SOURCE FORMAT IS ASSIGNED TO THE TARGET. 


FORMAT VARIABLES MAY BE COMPARED, BUT ONLY THE COMPARISON 
OPERATIONS EQUAL (=) AND NOT EQUAL (=) ARE PERMITTED. 


FORMAT VARIABLES AND CONSTANTS MAY BE PASSED AS PARAMETERS. 


THE FORMAT STATEMENT SPECIFIES A FORMAT LIST THAT CAN BE USED BY 
EDIT-DIRECTED STATEMENTS TO CONTROL THE FORM OF DATA. BEING 
TRANSMITTED 


FORMAT—CONSTANT : [FORMAT-CONSTANT: .. IFORMAT(<FORMAT LIST>); 
FORMAT CONSTANTS MAY BE SUBSCRIPTED. | 


THE R-FORMAT ITEM ALLOWS FORMAT ITEMS IN THE FORMAT STATEMENT TO 
REPLACE THE REMOTE (R) FORMAT Hi a = Bs 


R(FORMAT-DESIGNATOR) 


THE FORMAT DESIGNATOR IS A FORMAT CONSTANT (SUBSCRIPTED OR 
UNSUBSCRIPTED), AN ELEMENT FORMAT VARTABLE OR A FUNCTION REFERENCE 
* THAT RETURNS A FORMAT. 


EXAMPLE: | 


DECLARE (FV,FVA(10))FORMAT VARIABLE, X FIXED; 
FC: FORMAT(F(10)); 


FCA(1):° FORMAT(X(2),F(10,2)); 
FCA(2): FORMAT(X(5),F(10,5)); 
FV=FC; 
FVA(2)=FCA(1) ; 


PUT EDIT(X) (R(FVA(2))); 
PUT EDIT(X,X) (X(1) ,R(FC) ,R(FCA(1))): 


DO537 PLI — PRE-PROCESSOR PRECISN DEFAULT —- 08-26-7358 sae 


DO537 Pl - PRE-PROCESSOR PRECISN DEFAULT - 08-26-73 


PRECISION OF PREPROCESSOR DECIMAL FIXED HAS BEEN CHANGED TO (5,0). 


DO0538 PLI - KEYED FILE INTRINSICS - 09-09-73 


THE B6700 2.5 RELEASE WILL INCLUDE THE ISAM INTRINSICS COMPILED AS 
SYSTEM INTRINSICS. THESE INTRINSICS WILL BE USED BY THE NEWLY 
IMPLEMENTED PL/I KEYED 1/0 FEATURES, AND COINCIDENTALLY MAY BE 
CALLED DIRECTLY AS INSTALLATION INTRINSICS IN PL/I ALGOL AND COBOL. 
THE INTRINSICS WILL APPEAR IN THE NEW ESPOL SYMBOLIC "“SYMBOL/ 
PLINTRINSICS" AT SEQUENCE # 67549100 - 67643900. THESE INTRINSICS 
(ISOPEN, ISDELETE, ISWRITE, ISKEYWRITE, ISREADNEXT, ISREADREC, 
ISREAD, ISREWRITE, ISCLOSE AND ISLOCATE) WILL BE BOUND INTO SYSTEM/ 
INTRINSICS, AS INSTALLATION ONE INTRINSICS, AND WILL REQUIRE NO 
SOFTWARE CHANGES. 


ADDITIONALLY THE SPECIAL PL/I INTERFACE INTRINSICS (PLCLOSE, 
PLOPEN, PLDELETE, PLKEYWRITE, PLREADNEXT, PLREWRITE, PLREAD, 
PLWRITE) ARE INCLUDED IN THE SYMBOLIC AT SEQUENCE # 67700000 - 
67704200. THESE INTRINSICS ALLOW PROPER PARAMETER MATCHING IF THE 
ISAM INTRINSICS ARE TO BE REFERENCED AS BUILT-IN FUNCTIONS. THE © 
INTERFACE INTRINSICS MUST BE COMPILED AND BOUND TO SYSTEM/ 
INTRINSICS SPECIFICALLY BY THE USER: ? 


BIND 
PLCLOSE=3, 1 (PL/I; 
PLOPEN=3,e | (PL/I), 
FROM PL/=; 


IF THE BUILT-IN APPROACH 1S USED, THE USER MUST MODIFY HIS FILE 
DECLARATION TO SET THE DIRECT ATTRIBUTE (WHICH WAS PREVIOUSLY SET 
BY THE INTRINSIC AND REQUIRED AN MCP PATCH). THE FILE SHOULD BE 
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DOSSB = PLI- = KEYED FILE. INTRINSICS - 09-09-73 
DECLARED AS: 
PL/I: 
DECLARE <NAME> FILE...ENVIRONMENT (DIRECTIO=-TRUE-...):; 
(NOTE: THE DASH (-) HAS BEEN USED FOR THE SINGLE QUOTE.) 


THE FILE ATTRIBUTE "“DIRECTIO" WILL SET THE pB6700 DIRECT 1/0 
ATTRIBUTE AT FILE BUILDING TIME. "DIRECTIO" MAY NOT BE SET BY 
LABEL EQUATICN OR IN AN OPEN STATEMENT. 


THE "DIRECTIO" ATTRIBUTE IS NOT REQUIRED FOR THE NEW PL/I KEYED 1/0 
SYNTAX: 


DECLARE <NAME> FILE KEYED ENVIRONMENT (KIND=-DISK-) ; 
(NOTE: THE DASH (-) HAS BEEN USED FOR THE SINGLE QUOTE. ) 


IF THE ISAM INTRINSICS ARE TO BE USED BY OTHER LANGUAGES, THE 
DIRECT ATTRIBUTE MUST BE INDICATED IN THE FILE DECLARATION: 


COBOL : 
SELECT NAME ASSIGN TO DIRECT DISK 


ALGOL : . * anaes ee 
DIRECT FILE NAME (KIND=DISK) 


NEW FEATURES AND DOCUMENTATION CHANGES Ane. ee 


PLINTRINSICS 


THIS PATCH COMBINES ALL ESPOLINTRINSICS AND ALGOLINTRINSICS WHICH 
APPLY ONLY TO PL/I AND FORMS A NEW INTRINSIC SYMBOLIC CALLED 
SYMBOL/PLINTRINSICS. THESE INTRINSICS HAVE BEEN DELETED FROM 
SYMBOL/ESPOLINTRINSICS AND SYMBOL/ALGOLINTRINSICS. 


NEW FEATURES AND DOCUMENTATION CHANGES Bae eee 


RJE 


DO392. =RJE - INPUT MESSAGES - 07-08-73 


THIS PATCH IMPLEMENTS THE "WM" SM MESSAGE AND THE "DL" RSC MESSAGE. 
WHEN "<RJE MIX NUMBER>SM:WM" IS ENTERED AT THE SITE CONSOLE, RJE 
RESPONDS BY DISPLAYING ITS LEVEL AND COMPILE TIME DEBUG OPTION 
STATE AT THE CONSOLE. WHEN "DL" IS ENTERED AT AN RSC, THE DCP AND 
LINE. NUMBER OF THAT TERMINAL ARE DISPLAYED ON THE RSC IF RJE IS 
COMPILED WITH "DEBUG" SET. 


DO393 RJE —- NOLOGON COMPILETIME OPTION =~ O7-08=7S 


THIS PATCH IMPLEMENTS A NEW COMPILE TIME OPTION, “NOLOGON". WHEN 
THIS OPTION IS SET, ALL RJE STATIONS MAY BY DEFAULT LOG ON WITHOUT 
USERCODE AND PASSWORD. WHEN THE OPTION IS RESET (THE DEFAULT 


CONDITION), ALL STATIONS MUST BY DEFAULT PERFORM A COMPLETE LOG-ON 
SEQUENCE . : : 
DO394 ~~ RJE - NEW LINE DISCIPLINE - 07-14-73 


THIS PATCH IMPLEMENTS A NEW COMPILE TIME OPTION, "NEWLINE". - WHEN 
NEWLINE IS SET, AN RJE MCS IS GENERATED INCORPORATING A REVISED 
LINE DISCIPLINE. THIS OPTION IS RESET BY DEFAULT; THUS, THE 
RELEASED VERSION OF SYSTEM/RJE IS COMPATIBLE WITH 2.4 DC1000 LOADER 
DECKS. , 


poul4 = RUE - LC RSC INPUT MESSAGE - 07-29-73 PACE ©! 


DOWIY RYE = LC RSC INPUT MESSAGE = O%regz/s 
THIS PATCH IMPLEMENTS THE LC (LOG COMMENT) REMOTE CONSOLE INPUT 
MESSAGE. WHEN THE USER TYPES IN 


LC <TEXT> 


THAT TEXT IS ENTERED IN THE LOG FOR THAT SESSION AS AN "MCS 
MESSAGE" . 


DOHIS RIE = - RYE LEVEL IN RJELINKED FILE = O77e0773 

THIS PATCH CAUSES THE LEVEL OF AN ACTIVE RJE MCS TO BE RECORDED IN 
THE RJELINKED FILE IT GENERATES. THIS INFORMATION IS RECORDED IN 
WORD 52 OF BLOCK ZERO AS A STRING OF EBCDIC CHARACTERS. THE FIRST 
CHARACTER YIELDS THE MARK NUMBER, THE NEXT TWO CHARACTERS THE LEVEL 
NUMBER, AND THE FINAL THREE CHARACTERS THE CYCLE NUMBER. FOR 
EXAMPLE: “204090". 


DORIS, “RYE. 2. TURBOVED CALLBACK HANDLING = 07-29-73 

THIS PATCH CORRECTS THE HANDLING OF PRINTER BACKUP FILES GENERATED 
BY TWO OR MORE DIALIN TERMINALS CALLING INTO THE SAME MODEM 
SERIALLY AND EMPLOYING THE "CALLBACK" RUN-TIME UNIT OPTION. THE 
PREVIOUS IMPLEMENTATION OF RJE RECOGNIZED ALL SUCH TERMINALS AS 
HAVING THE SAME LSN; THEREFORE, THE LAST PHONE NUMBER PROVIDED TO 
RJE BY A STATION LOGGED-IN ON THIS LINE WAS USED WHEN A DIALOUT WAS 
PERFORMED. THE TERMINAL CALLED THUS RECEIVED ALL OUTPUT FROM ALL 
TASKS INITIATED BY TERMINALS BEFORE THEY LOGGED-OFF ON THAT LINE. 


THE SOLUTION IMPLEMENTED BY THIS PATCH INVOLVES THE INCORPORATION 
OF A NEW "STATIONID" RUN-TIME OPTION INTO RJE. THIS OPTION MAY BE 
SET AND RESET IN THE SAME MANNER AS THE "LOGON" AND "USER" OPTIONS. 
WHEN “STATIONID" IS SET FOR A TERMINAL, A USER MAY NOT LOG-ON AT 
THAT TERMINAL UNTIL HE HAS TYPED IN A VALID RJE DC1000 STATION NAME 


DO416 RUE - IMPROVED CALLBACK HANDLING - 07-29-73 PASE 20e 


AT HIS RSC. THE DEFAULT STATE OF THIS OPTION IS RESET. SINCE THE 
USE OF THIS OPTION INVOLVES POSSIBLE DATACOM RECONFIGURATION, IT 
SHOULD BE EMPLOYED AS SPARINGLY AS POSSIBLE. 


WHEN "STATIONID" AND "LOGON" ARE SET, A NEW REQUEST IS ADDED TO THE 
LOG-ON SEQUENCE AS FOLLOWS: 


#AND YOUR STATION NAME. 


WHEN "STATIONID" IS SET AND “LOGON" IS RESET, THE USER MUST SATISFY 
THE REQUEST: 


#ENTER STATION NAME PLEASE 
BEFORE BEING LOGGED-ON BY RJE. 
SYSTEM REQUIREMENTS 


EACH TERMINAL WHICH MAY CALL-UP RJE ON A LINE MUST BE ASSIGNED A 
UNTQUE STATION NAME. TO FACILITATE THIS, EACH SUCH STATION MUST BE 
DESCRIBED AS A COMPLETE RJE TERMINAL IN THE NDL DESCRIPTION OF THE 
NETWORK. ALL LINES BEARING THESE TERMINALS MUST BE OF DIALIN- 
DIALOUT TYPE WITH APPRORPRIATE ACU-S. THIS HARDWARE NEED NOT BE 
ACTUALLY PRESENT. 


THE COMPILETIME RJE DEFINES, MAXTERMINALS AND MAXTERMINALSLOG2, 
MUST BE LARGE ENOUGH TO ENCOMPASS AS MANY TERMINALS AS ARE PLACED 
UNDER THE CONTROL OF THIS MCS. FOR PROPER OPERATION OF THIS PATCH, 
"STATIONID" MUST BE SET FOR EACH OF THESE STATIONS; THESE MUST BE 
THE ONLY STATION NAMES ENTERED IN RESPONSE TO A REQUEST DURING THE 
LOG-ON SEQUENCE. 


OPERATING PROCEDURES 
WHEN CHANGING TO A VERSION OF THE RJE MCS INCORPORATING THIS PATCH 
FROM AN EARLIER VERSION, THE RJELINKED FILE GENERATED BY THE 
PREVIOUS RJE MUST BE REMOVED AS THIS PATCH INVOLVES AN ALTERATION 
OF THE FORMAT OF THIS FILE. 


NEXT, THE "“STATIONID" OPTION MUST BE SET FOR EACH APPROPRIATE 
DIALIN-DIALOUT DC1000 LSN. THIS MAY BE ACCOMPLISHED THROUGH SM 


DO4¥16 RUE - IMPROVED CALLBACK HANDLING - 07-29-73 PACE 9% 


SYSTEM INPUT MESSAGES OF THE FOLLOWING FORM: 
<RJE MIX NUMBER> SM: <DC1000 LSN> SO STATIONID 


IF ANY OF THE TERMINALS THUS REFERENCED ARE ACTIVE WHEN "STATIONID" 
IS NEWLY SET, THEY WILL NOT BE LOGGED-OFF AS IS THE CASE WITH THE 
"LOGON" OPTION. 


THE FORMAT OF BACKUP FILES GENERATED BY TASKS INITIATED BY THESE 
TERMINALS WILL CONFORM TO PREVIOUS FORMATS; THE TITLES OF THESE. 
FILES WILL CONTINUE TO CONTAIN THE LSN OF THE INITIATING DC1000 
STATION AND THE SESSION NUMBER OF THE INITIATING SESSION. 


WHEN A USER ATTEMPTS TO LOG-ON AT A TERMINAL FOR WHICH "STATIONID" 
IS SET, HE WILL KNOW THAT RJE IS SATISFIED WITH THE STATION NAME HE 
HAS TYPED-IN WHEN THE FOLLOWING MESSAGE IS TYPED ON HIS RSC: 


#RECONF IGURATION COMPLETED. 


OR WHEN HE RECEIVES THE STANDARD LOG-ON MESSAGE. THE ABOVE MESSAGE 
WILL BE TYPED IF ANY DATACOM RECONFIGURATION WAS REQUIRED. ANY 
ABORTED RECONFIGURATION ATTEMPTS FROM WHICH RJE WAS ABLE TO RECOVER 
WILL BE NOTED BY APPROPRIATE MESSAGES AT THE RSC. (COMPILING WITH 
DEBUG SET PROVIDES ADDITIONAL AIDS.) 


THE RECONFIGURED RJE NETWORK MAY BE EXAMINED VIA THE "US" RSC INPUT 
MESSAGE . , 


IF FOR ANY REASON A DC1000 STATION IS ERRONEOUSLY LEFT WITH NO LINE 
ASSIGNMENT, THE FOLLOWING MESSAGE WILL BE DISPLAYED AT THE SYSTEM 
SPO: 


<DC1000 LSN> : NOT ATTACHED. 
SUCH A CONDITION WILL REQUIRE REINITIALIZATION OF THE, DCP. 


DUE TO THE PITFALLS INVOLVED IN RECONFIGURATION, IT IS. AGAIN URGED 
THAT THE STATIONID OPTION BE USED SPARINGLY; IT IS ALSO RECOMMENDED 
THAT THE RJE MCS BE COMPILED WITH THE DEBUG COMPILETIME OPTION SET 
FOR INITIAL OPERATION. | 


PA 204 
DO439 RJE - USERCODE IN PD MESSAGE - 08-12-73 te 


DO439 RJE ~- USERCODE IN PD MESSAGE - 08-12-73 


THIS PATCH CAUSES RJE TO ACCEPT THE PARENTHESIZED FORM OF A 
USERCODE IN THE "PD" RSC MESSAGE. FOR EXAMPLE : 


PD (MYCODE)A/B 


DOS11 RUE = HANDLING OF INCOMPAT LINK FILE - 08-19-73 
THIS PATCH CAUSES RJE TQ DISCARD INCOMPATIBLE RJELINKED FILES 
DURING INITIATION. 


DO512  RJE = IMPLEMENTATION OF 2PB STMT - 09-04-73 
THIS PATCH REPRESENTS A TEMPORARY IMPLEMENTATION OF A FORM OF THE. 
"PB" MCP CONTROL STATEMENT (DISTINCT FROM THE "PB" RSC INPUT 
MESSAGE). THE SYNTAX OF THE NEW CONTROL STATEMENT IS: 


<PB CS>::= <1>PB<MIX NUMBER><FILE ID><PB OPTIONS> 
<I1>::= £INVALID CHARACTER (? FOR RSC) 

<FILE I1D>::= <EMPTY> / <SLASH><FILE NAME> 
<SLASH>::= / 


WHERE <MIX NUMBER> REFERS TO THE TASK WHICH GENERATED THE BACKUP 
FILE, <PB OPTIONS> INCLUDE THE ASSOCIATIVE AND GENERAL’ OPTIONS 
RECOGNIZED BY THE WORK FLOW LANGUAGE PB STATEMENT (E.G., SAVE, 
KEY, RANGE, RECORD, ETC.) AND THEIR PARAMETERS, AND <FILE NAME> IS 
THE TITLE PART OF THE BACKUP FILE ENTRY. AT LEAST ONE <PB OPTIOND> 
MUST BE PRESENT. , ; 


THE FOLLOWING ARE VALID EXAMPLES OF THE PB RJE CONTROL STATEMENT: 


?PB 1939 KEY ALGOL RANGE 10046000 10059000 SAVE 
?PB 73/000LINE KEY 2 3 RANGE 60 80 


THE FUNCTION OF THE STATEMENT IS TO INITIATE AN EXECUTION OF 
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_SYSTEM/BACKUP, USING AN ENTRY IN THE RJESAVEBD DIRECTORY OF BACKUP 
FILES AS INPUT. BACKUP GENERATES A COPY OF THE SPECIFIED PORTION 
OF THE INPUT FILE ON DISK IN THE RJEBD DIRECTORY WHICH IS THEN 
PRINTED BY THE AUTOPRINT ROUTINE OF RJE. 


IF THE SESSION IS RUNNING UNDER A USERCODE OR IF THE "SAVE" PB 
OPTION IS SPECIFIED, THE ORIGINAL RJESAVEBD FILE IS RETAINED ON 
DISK AFTER THIS OPERATION, OTHERWISE THE FILE IS DISCARDED. 


INDISCRIMINANT USE OF THIS CONTROL STATEMENT SHOULD BE AVOIDED AS 
IT CAN LEAD TO HEAVY DISK USAGE. 


THIS PATCH ENABLES RJE TO PUNCH BACKUP FILES AT A REMOTE TERMINAL. 
THE PATCH IS ENABLED BY SETTING THE "REMOTEPUNCH" COMPILE TIME 
OPTION WHEN COMPILING RJE. A NEW RUN TIME OPTION, ALSO CALLED 
"REMOTEPUNCH", IS IMPLEMENTED AND MAY BE SET BY A USER EMPLOYING A 
TERMINAL POSSESSING A PUNCH. THE REMOTE COMPUTER MUST BE LOADED IN 
SUCH A MANNER AS TO BE ABLE TO DRIVE A CARD PUNCH. 


RJE MUST BOTH BE COMPILED WITH "“REMOTEPUNCH" SET AND THE 
“REMOTEPUNCH" OPTION MUST BE SET BY THE USER (VIA THE "SO" RSC 
INPUT MESSAGE) BEFORE PUNCHING WILL OCCUR AT HIS TERMINAL. . 
OTHERWISE, PUNCHING OF PUNCH BACKUP FILES WILL BE ATTEMPTED AT THE 
CENTRAL SITE. BOTH THE COMPILE TIME AND RUN TIME OPTIONS ARE RESET 
BY DEFAULT. 


NEW FEATURES AND DOCUMENTATION’ CHANGES re “GOs 


RLTABLEGEN 


THIS PATCH MODIFIES THE SYNTAX OF THE ID STATEMENT AND ALLOWS THE 
USER TO SPECIFY THE PARAMETER NSUSASI. 


ID STATEMENT: 


ID statement 


Comments 


BCL 
MODE= ~_ 
EDCDIC 


ID 


IDENTIFICATION 


SYNTAX 
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NEW FEATURES AND DOCUMENTATION CHANGES 


DO352 SCR —-= NEW MAT DOCUMENTATION 


THIS SYSTEM NOTE IS THE REFERENCE POINT FOR ALL THE PATCHES WHICH 
INFLUENCE DOCUMENTATION FOR THE MAINTENANCE AND TEST (MAT) LANGUAGE 


INFORMATION MANUAL. 
NEW MANUAL . 


DO0539 SCR - DELETION OF THE 


THE ACTUAL DOCUMENTATION WILL BE FOUND IN THE 


"FESTS" TAPE = 09-23-73 


THE "SYSTESTS" TAPE WITH THE 2.5 SYSTEM RELEASE IS PRIMARILY A 


FIELD ENGINEERING DOCUMENT. 
BEING INCLUDED ON THE 
MAINTENANCE PROGRAMS ARE 


IN ADDITON TO ALL THE "MASTER TESTS" 
"SYSTESTS" 
ALSO CONTAINED THEREON ALONG WITH NEW 


TAPE ALL PREVIOUSLY RELEASED 


MAINTENANCE PROGRAMS DESCRIBED IN ADVANCE TECHNICAL INFORMATION 11B. 


THE FOLLOWING NAME CHANGES HAVE BEEN MADE TO THE "TESTS" TAPE: AND 
"TOINTERACT" HAS BEEN REMOVED FROM THE "SYSTEM" AND "SYMBOL" TAPES. 


2.4 
"TESTS" 


TEST/XALGOL 
TEST/ALGOL 
TEST/COBOL 
TEST/FORTRAN 
TEST/XFORTRAN 
TEST/ALGOLSORT 
TEST/BASIC 
TEST/COBOLSORT 
TEST/PLI 

SOURCE/ TEST/XALGOL 
SOURCE/ TEST/ALGOL 


2.5 
"SY STE STO" 


SYSTEST/LANG/ XALGOL 
SYSTEST/LANG/ ALGOL 
SYSTEST/LANG/ COBOL 
SYSTEST/LANG/FORTRAN 
SYSTEST/LANG/ XFORTRAN 
SYSTEST/LANG/ALGOLSORT 
SYSTEST/LANG/BASIC 
SYSTEST/LANG/COBOLSORT 


. SYSTEST/LANG/PLI 


SYMTEST/LANG/ XALGOL 
SYMTEST/LANG/ ALGOL 


2.4 
"TESTS" 


SOURCE / TEST /COBOL 
SOURCE/ TEST/FORTRAN 
SOURCE / TEST/ALGOLSORT 
SOURCE/ TEST/XFORTRAN 
SOURCE/TEST/BASIC 
SOURCE/TEST/PLI 
DATA/TEST/PLI 
TEST/AES 

TEST/AEY 
SOURCE/TEST/AE3 . 
SOURCE/TEST/AEY 
SYSTEM/ IOINTERACT 
SYMBOL/ IOINTERACT 
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SYMTEST/LANG/ COBOL 
SYMTEST/LANG/FORTRAN 
SYMTEST/LANG/ ALGOLSORT 
SYMTEST/LANG/ XFORTRAN 
SYMTEST/LANG/BASIC 
SYMTEST/LANG/PLI 
SYMTEST/LANG/DATAPLI 
SYSTEST/PROC/ AES 
SYSTEST/PROC/ AEY 
SYMTEST/PROC/AE3 
SYMTEST/PROC/ AEY 
SYSTEST/10/ IOINTERACT 
SYMTEST/ 1O/ IOINTERACT 
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NEW FEATURES AND DOCUMENTATION CHANGES pra “Gee 


SOURCENDL 


DO307 SOURCENDL - IMPLEMENTN OF TO700 TERMINALS —- 05-07-73 


TD700 TERMINALS DESIGN LEVEL ONE REQUEST SETS HAVE BEEN IMPLEMENTED. 
IN THESE REQUEST SETS NO CARRIAGE CONTROL CONSTRUCTS ARE 
IMPLEMENTED, SINCE THE TERMINAL IS NOT CAPABLE OF USING THEM 
CORRECTLY. THE SAME IS TRUE FOR SEQUENCE MODE; IF AN MCS SETS TOG 
[0] IN ORDER TO INDUCE SEQUENCE MODE, THE MESSAGE "SEQ MOD NOT 
IMPLEMENTED" IS SENT TO THE TERMINAL BY THE DCP AND AN EMPTY INPUT 
MESSAGE GENERATED TO INDICATE THE END OF SEQUENCE MODE TO THE MCS. 


2741 TYPE TERMINAL REQUEST SETS HAVE BEEN IMPLEMENTED FOR THE 
CORRESPONDENCE CODE SET (SELECTRIC TYPEWRITER KEYBOARD), USING THE 
REVERSE BREAK OPTION. 


THE FOLLOWING NON-EBCDIC DEFINED CHARACTERS ARE TRANSLATED AS 
FOLLOWS: 


UPPER CASE 1 AS < 

EXCLAMATION MARK AS > 

UPPER CASE SIX AS LEFT BRACKET 

UPPER CASE EXCLAMATION MARK AS RIGHT BRACKET 


AN OPTIONAL TRANSLATION TABLE HAS BEEN PROVIDED FOR USERS WHO WISH 
TO HAVE LOWER CASE ALPHA CHARACTERS ON INPUT TRANSLATED TO UPPER 
CASE ALPHA CHARACTERS (THIS FACILITATES THE MANIPULATION OF ALGOL — 
TYPE FILES THROUGH CANDE BECAUSE THE ALGOL COMPILER DOES NOT ACCEPT 
LOWER CASE CHARACTERS). IF THIS IS DESIRED, SOURCENDL HAS TO BE 
RECOMPILED WITH THE OPTIONAL TRANSLATE TABLE REFERENCED, I.E., THE 
FOLLOWING PATCH MAY BE USED: 
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DOY17 SOURCENDL - 2741 TYPE TERMINALS = O7=2e9-75 


CHAR = CORTOEBCUP (CHAR). 24467000 


IN ESTABLISHING CONNECTION WITH THE TERMINAL, THE USER IS REQUIRED 
NOT TO ENTER INPUT UNTIL EITHER AN OUTPUT MESSAGE OR A CARRIAGE 
RETURN INDICATES THE PROPER COMPLETION OF THE INITIAL DIALUP 
SEQUENCE . 


Does = SOURCENDL == APL REQUEST SETS FOR e741 TERM - 09-09-73 
REQUEST SETS HAVE BEEN IMPLEMENTED FOR THE USE OF A 2741 TERMINAL 
AS AN APL TERMINAL. THE TERMINAL HAS TO USE APL CORRESPONDENCE 
CODE AND HAS TO BE EQUIPPED WITH THE PROPER TYPE SPHERE. THE 
REQUEST SETS REQUIRE THE USE OF APL AS THE CONTROLLING MCS. 


DONBE = SOURCENDLE == PRELIM IMPLEM OF TO800 TERM ~ 09-16-73 

THE IMPLEMENTATION OF TD800 TERMINALS IS PRELIMINARY AND DOES NOT 
REFLECT A QUALIFICATION OF THIS DATACOM TERMINAL AS OF THIS DATE. 
THE FOLLOWING FUNCTIONS ARE NOT IMPLEMENTED AS OF NOW BY THE 
SOFTWARE OR ARE NOT AVAILABLE IN THE HARDWARE: 


1. FORMS MODE (AS USED BY CANDE FOR SEQUENCE MODE) 


e. MULTIPLE RECORD INPUT (THE TERMINAL IS NOT.CAPABLE OF 
TRANSMITTING CR) 


3. SPECIAL FUNCTION CHARACTERS, SUCH AS LINE ERASE AND 
TABULATION. 


DO513 SOURCENDL - DYNAMIC TRANSLATION POR) esol. = 07-1473 


IT IS NOW POSSIBLE TO HAVE ALL LOWER CASE ALPHA CHARACTERS ON A 
2741 TRANSLATED TO UPPER CASE BY ENTERING QUESTION MARK MINUS (?-) 
FROM THE TERMINAL. ALL LOWER CASE CHARACTERS WILL BE TRANSLATED 
UNTIL A QUESTION MARK PLUS (?+) IS ENTERED. 


NEW FEATURES AND DOCUMENTATION CHANGES Pane se 


XREF ANALYZER 


A COMPILE TIME OPTION "FAST" HAS BEEN ADDED TO XREFANALYZER. WHEN 
"FAST" IS SET, ALL BLANK LINES ARE ELIMINATED FROM THE XREF, THE = 
SIGNS ARE REPLACED WITH E-S, THE ::-S ARE CHANGED TO -- S, AND THE 
@ SIGNS ARE REPLACED WITH "AT". THE EFFECT OF THE CHARACTER 
SUBSTITUTIONS IS TO INCREASE THE PRINTING SPEED FROM TO 800 TO 1100 
LINES PER MINUTE. WITH "FAST" RESET, THE XREF APPEARS AS BEFORE, 
EXCEPT SOME OF THE BLANK LINES ARE ELIMINATED. ("FAST" WILL BE SET 
ON THE RELEASE VERSION.) 


DO54Y0 © XREFANALY - INSTALLATION INTRINSICS = 09-23-73 
INSTALLATION INTRINSICS APPEAR IN AN XREF PRINTOUT AS IF THEY WERE 
DECLARED AT THE LINE CONTAINING THE FIRST BEGIN STATEMENT (I.E., 
AT THE BEGINNING OF THE OUTER BLOCK). : 
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SYSTEM MARKETING MARKET ING 


DOCUMENT NOTE NO. DATE 
ALGOL COMPILER DOZ59 5000136 06-72 
ALGOL COMPILER DO367 5000136 06-72 
ALGOL COMPILER Do4u4O 5000136 06-72 
ALGOL LANGUAGE b0300 5000128 06-72 
ALGOL LANGUAGE Do3e6 §=©6©5000128 06-73 | 
ALGOL LANGUAGE 00327. 5000128 06-72 
ALGOL LANGUAGE _ ; bo330 5000128 06-72 
ALGOL LANGUAGE D0262 5000128 06-72 
ALGOL LANGUAGE DOZ64 50001e8 . 06-72 
ALGOL. LANGUAGE DO365 5000128 06-72 
ALGOL LANGUAGE bDO3z66 §=6. 5000128 06-72 
ALGOL LANGUAGE po380 =6- 5000128 06-72 
ALGOL. LANGUAGE DO0395 5000128 06-72 
ALGOL LANGUAGE DowoOo §=©9— 5000128 06-72 
ALGOL LANGUAGE DO4“O! #5000128 06-72 
ALGOL LANGUAGE po4uoe 5000128 06-72 
ALGOL LANGUAGE Do4¥e7 =. 5000128 06-72 
ALGOL LANGUAGE DO4u30 ©§000128° 06-72 
ALGOL LANGUAGE po4¥41 5000128 06-72 . 
ALGOL LANGUAGE Dou42 5000128 06-62 
ALGOL LANGUAGE Dow43s 5000128 06-72 
ALGOL LANGUAGE DOYY4Y 5000128 06-72 
ALGOL LANGUAGE DOYsS 5000128 06-72 
BASIC LANGUAGE | D0335 5000383 07-71 
BASIC LANGUAGE DO4s0 =. 5000383 07-71 
BINDER DO4¥Z6 = §=5000045 11-71 
’ BINDER pouw46 5000045 . 11-71 
BINDER ~— poy49g = 5000045 11-71 
BINDER po4u50. = 5000045 11-71 


CANDE LANGUAGE . DOe95 5000318 10-72 
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SYSTEM MARKETING MARKETING 


DOCUMENT NOTE NO. DATE 
CANDE LANGUAGE DO301 5000318 10-72 
CANDE LANGUAGE Do302 5000318 10-72 
CANDE LANGUAGE DO0303 5000318 10-72 
CANDE LANGUAGE DO304 5000318 10-72 
CANDE LANGUAGE bDo305 5000318 10-72 
CANDE LANGUAGE DO306 5000318 “10-72 
CANDE LANGUAGE DO360 5000318 10-72 
CANDE LANGUAGE DO369 5000318 10-72 
CANDE LANGUAGE DOYS51 | 5000318 10-72 
CANDE LANGUAGE poywse 5000318 10-72 
CANDE LANGUAGE DOY5Y4 5000318 10-72 
CANDE LANGUAGE DO455 5000318 10-72 
CANDE LANGUAGE DO4U5s6 5000318 10-72 
CANDE LANGUAGE DO4u81 5000318 10-72 
CANDE LANGUAGE DO514 5000318 10-72 
CANDE LANGUAGE DO516 5000318 10-72 
CANDE LANGUAGE DO517 5000318 | 10-72 
CANDE LANGUAGE bpo519 5000318 10-7e 
CANDE OPERATION DO361 5000615 10-72 
CANDE OPERATION DO368 5000615 10-72 
CANDE OPERATION DO453 5000615 10-72 
CANDE OPERATION bDo4u55 5000615 10-72 
CANDE OPERATION DO515 5000615 ~ 10-72 
CANDE OPERATION ~ ~Dp0517 5000615 - 10-7e 
CANDE OPERATION DO518 5000615 ‘10-7e 
COBOL REFERENCE Doess 5000656 02-73 
COBOL: REFERENCE DO349 5000656 02-73 
COBOL REFERENCE DO370 5000656 02-73 
COBOL REFERENCE DOYve7 5000658 02-73 
COBOL REFERENCE DO436 5000656 ' 02-73 
COBOL REFERENCE DO4U57 5000656 — 02-73 
~ COBOL REFERENCE DO458 5000656 02-73 


COBOL REFERENCE DOYSS 5000656 02-73 
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SYSTEM MARKETING MARKETING 

DOCUMENT NOTE NO. DATE 

COBOL REFERENCE DOYGO 8=— 500065¢€ 02-73 
COBOL REFERENCE DO461 500065€ 02-73 
COBOL REFERENCE DO4u6e) = 500065* 02-73. 
COBOL REFERENCE . DOo4u63 =: 5000656 02-73 
COBOL REFERENCE bo4u64y 5000656 02-73 
COBOL REFERENCE bD05e5 5000656 02-73 
COBOL REFERENCE b052e7) = 5000235 01-73 
COBOL REFERENCE bDo5e8 4+°=s- 5000235 01-73 
DATA MANAGEMENT DOZ14 5000235 01-73 
DATA MANAGEMENT 00315 5000235 01-73 
DATA MANAGEMENT | DO316 500235 01-73 
DATA MANAGEMENT D0353 5000235 01-73 
DATA MANAGEMENT DOZ54 5000235 04-73 
DATA MANAGEMENT DO3Z56 5000235 01-73 
DATA MANAGEMENT DO357 5000235 04-73 
DATA MANAGEMENT —  povoy 5000235 04-73 
DATA MANAGEMENT DOYO5)§=§=6§000235 04-73 
DATA MANAGEMENT DOYO6)§=§=65000235 04-73 
DATA MANAGEMENT bDe418 5000235 04-73 
DATA MANAGEMENT DO419 5000235 04-73 
DATA MANAGEMENT Do5e6 = 5000235 01-73 
DATACOM FUNCTIONAL poe9e =65000060 03-73 
DCALGOL LANGUAGE Do309 5000052 06-73 
DCALGOL LANGUAGE DO0312 5000052 06-73 
DCALGOL LANGUAGE DO317 5000052 06-73 
DCALGOL LANGUAGE DO375 5000052 06-73 
DCALGOL LANGUAGE DO376 §©500005e 06-73 
DCALGOL LANGUAGE bDo388 5000052 06-73 
DCALGOL LANGUAGE DO470 »©=6 5000052 06-73 
DCALGOL LANGUAGE DOY71 5000052 06-73 
DCALGOL LANGUAGE po4¥s9 = 5000052 06-73 
DUMP ANALYZER DO4“87 = =§=6§ 000334 11-71 
ESPOL LANGUAGE boz00 = =©§©65 000094 06-72 
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SYSTEM MARKETING MARKET ING 


DOCUMENT NOTE NO. DATE 

ESPOL LANGUAGE bo34o0 8©=©5000094 06-72 
ESPOL LANGUAGE DO341 5000094 06-72 
ESPOL LANGUAGE po34e 5000094 06-72 
ESPOL LANGUAGE po363 5000094 06-72 
ESPOL LANGUAGE po¥7e 5000095 06-72 
ESPOL LANGUAGE p0531 5000095 06-72 
FORTRAN REFERENCE p0325 5000458 06-72 
FORTRAN REFERENCE Do343 5000458 06-72 
FORTRAN REFERENCE po¥et 5000458 06-72 
FORTRAN REFERENCE pov¥2e6 5000458 06-72 
FORTRAN REFERENCE po4u73 5000458 06-72 
FORTRAN REFERENCE DOY74 5000458 06-72 
I-O SUBSYSTEM bo3Sg8 5000185. 07-71 
1-O SUBSYSTEM D04Y76 5000185 07-71 
MCP . po4uog 5000086 12-71 
MCP | Do4¥34 5000086 12-71 
MCP Pe62e5 5000086 12-71 
MCSII USERS GUIDE po5e3 5000219 09-71 
NDL poes4 5000078 08-71 
NDL D0319 .5000078 08-71 
NDL po350 5000078 08-71 
NOL po4¥1e 5000078 08-71 
NDL pov2e 5000078 08-71 
NDL DOo4¥78 5000078 08-71 
NDL po4¥s5 5000078 08-71 
NDL po4¥s6 5000078 08-71 
NDL 7 D0513 5000078 08-71 
PLI LANGUAGE D0433 5000201 10-72 
PLI LANGUAGE po4¥s3 =©5000201 10-72 
PLI LANGUAGE po¥ss 5000201 10-72 
PLI LANGUAGE po500 = =©5000201 10-72 
PLI LANGUAGE DO501 5000201 10-72 


PLI LANGUAGE DO50e 5000201 10-7e 
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SYSTEM MARKETING MARKET ING 

DOCUMENT NOTE NO. DATE 

PLI LANGUAGE DO503 5000201 10-7e 
PLI LANGUAGE DO504 5000201 10-7e 
PLI LANGUAGE DO505 5000c01 10-7e 
PLI LANGUAGE DO506 5000e01 10-7e 
PLI LANGUAGE DOSO7 5000201 10-73 
PLI LANGUAGE DO508 5000201 10-7e 
PLI LANGUAGE DO509 5000201 10-72 
PLI LANGUAGE DO510 5000201 10-7e 
PLI LANGUAGE DO0535 5000201 10-7e 
PLI LANGUAGE DO0536 5000201 10-7e 
PLI LANGUAGE D0537 5000201 , 10-72 
PLI LANGUAGE D0538 5000201 10-7e 
PROGRAM-DECK LOADER D0530 5000755 10-73 
RJE DO39e2 5000300 06-72 
RJE D0393 5000300 06-72 
RJE DO394 5000300 06-7e 
RJE DOYIY 5000300 06-72 
RJE DOY15 5000300 06-7e 
RJE. DO416 5000300 06-7e 
RJE DO0439 5000300 06-72 
RJE DO511 5000300 06-72 
RJE DO51e 5000300 06-72 
RJE DO5e1 5000300 06-72 
SOFTWARE HANDBOOK DO2e8s 500072e 01-72 
SOF TWARE HANDBOOK DOe93 50007ee 01-71 
SOFTWARE HANDBOOK - DO308 5000722 01-7e 
SOFTWARE HANDBOOK DO310 50007ee 01-7e 
SOFTWARE HANDBOOK DOS311 500072e 01-72 
SOFTWARE HANDBOOK D0313 500072e - 01-7e 
SOFTWARE HANDBOOK DO318 5000722 01-72 
SOFTWARE HANDBOOK DOS21 500072e 07-73 
SOF TWARE HANDBOOK DO326 5000722 07-73 
SOFTWARE HANDBOOK DO331 50007ee 07-73 


DOCUMENT 


_ SOF TWARE 
SOFTWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOFTWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOFTWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOFTWARE | 
SOF TWARE 
SOFTWARE 
SOFTWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 
SOF TWARE 


HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 


HANDBOOK — 


HANDBOOK 
HANDBOOK 
HANDBOOK 
HANDBOOK 


DOCUMENTS AFFECTED 


SYSTEM MARKETING | 


NOTE 


D0333 
DO334 
D0336 
DO0337 
D0338 
DOS344 
DOSH5 
DO346 
DO351 
DO371 
DO373 
DO3744 
DO377 
DO0379 
D0381 
bO38e2 
DO0383 
D0387 
D0388 
DO391 
DO396 
DO398 
DO4WO7 
DO4O8 
DOYW10 
DO4eO 
DOYe4 
DOYeS 
DOY“eS 


DO0435. 


DOYYS 
DOY4YS 
DOYES 


NO. 


5000722 
5000722 
5000722 
5000722 


5000722 


5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5900722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
5000722 
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MARKETING 


DATE 


07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 


07-73: 


07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 


C713 = 


07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 

07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
07-73 
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SYSTEM MARKETING MARKET ING 

DOCUMENT NOTE NO. DATE 

SOF TWARE HANDBOOK DO46E 5000722 . 07-73 
SOFTWARE HANDBOOK DO467 5000722: 07-73 
SOF TWARE HANDBOOK DO468 5000722 07-73 
SOF TWARE HANDBOOK DOW69 5000714 07-73 
SOF TWARE HANDBOOK DOY74 5000722 07-73 
SOF TWARE HANDBOOK DO475 5000722 07-73 
SOF TWARE HANDBOOK DOU77 5000722 07-73 
SOF TWARE HANDBOOK DO4SO 5000722 07-73 
SOFTWARE HANDBOOK DOY81 5000722 07-73 
SOF TWARE HANDBOOK DO483 5000722 07-73 
SOF TWARE HANDBOOK DOSY 5000722 07-73 
SOF TWARE HANDBOOK DO4SE 5000722 07-73 
SOF TWARE HANDBOOK DOYSss 5000722 O7-73 
SOFTWARE HANDBOOK DO4S7 5000722 07-73 
SOFTWARE HANDBOOK Do4ugs 5000722 07-73 
SOFTWARE HANDBOOK DO507 5000722 07-73 
SOFTWARE HANDBOOK DO516 5000722 07-73 
SOFTWARE HANDBOOK bo5e0 5000722 07-73 
SOFTWARE HANDBOOK bo5e4 5000722 07-73 
SOF TWARE ’ HANDBOOK DO5e7 5000722 07-73 
SOFTWARE HANDBOOK DO5esg 5000722 07-73 
SOF TWARE HANDBOOK Do532 5000722 07-73 
SOFTWARE HANDBOOK DO533 5000722 07-73 
SOF TWARE HANDBOOK DO534 5000722 07-73 
SOF TWARE HANDBOOK D0539 5000722 07-73 
SOFTWARE HANDBOOK DO540 5000722 07-73 
SORT PROGRAM DO370 5000144 12-71 
SYSTEM MISCELLANEA DOe8s 5000367 04-73 
SYSTEM MISCELLANEA DOe91 5000367 10-72 
SYSTEM MISCELLANEA DO297 5000367 04-73 
SYSTEM MISCELLANEA DOes9 5000367 04-73 
SYSTEM MISCELLANEA DO307 5000367 04-73 
SYSTEM MISCELLANEA DO311 5000367 © 04-73 
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SYSTEM MARKETING MARKET ING 
eee ae Ne DATE 
SYSTEM MISCELLANEA D0321 5000367 04-73 
SYSTEM MISCELLANEA D0333 5000367 04-73 
SYSTEM MISCELLANEA DO334 5000367 04-73 
SYSTEM MISCELLANEA DO358 5000367 04-73 
SYSTEM MISCELLANEA DO372 500367 04-73 
SYSTEM MISCELLANEA DO384 5000367 04-73 
SYSTEM MISCELLANEA DO389 5000367 04-73 
SYSTEM MISCELLANEA DO390 5000367 04-73 
SYSTEM MISCELLANEA D0397 5000367 04-73 
SYSTEM MISCELLANEA DO399 5000367 04-73 
SYSTEM MISCELLANEA DOYWOS 5000367 04-72 
SYSTEM MISCELLANEA DO4W13 5000367 04-73 
SYSTEM MISCELLANEA DOW17 5000367 O4=73 
SYSTEM MISCELLANEA DO4“32 5000367 04-73 
SYSTEM MISCELLANEA DO437 5000367 04-73 
SYSTEM MISCELLANEA DO438 5000367 04-73 
SYSTEM MISCELLANEA DOYY7 5000367 04-73 
SYSTEM MISCELLANEA DOES 5000367 04-73 
SYSTEM MISCELLANEA DOW77 5000367 04-73 
SYSTEM MISCELLANEA DO48O 5000367 04-73 
SYSTEM MISCELLANEA DOU8e2 5000367 04-73 
SYSTEM MISCELLANEA DOY83 5000367 04-73 
SYSTEM MISCELLANEA DO485 5000367 04-73 
SYSTEM MISCELLANEA DO4Y88 5000367 04-73 
SYSTEM MISCELLANEA DOY91 5000367 04-73 
SYSTEM MISCELLANEA DOY9e 5000367 04-73 
SYSTEM MISCELLANEA DO4S9S8 5000367 04-73 
SYSTEM MISCELLANEA DO5ee 5000367 ~O4-73 
SYSTEM MISCELLANEA DOS23 5000367 04-73 
SYSTEM MISCELLANEA DO53e2 5000367 04-73 
SYSTEM MISCELLANEA DO534 5000367 04-73 
SYSTEM MISCELLANEA DOS] 5000367 OSES 
SYSTEMSTATUS INTRN DO388 50004e5 04-72 
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DOCUMENT » NOTE NO. DATE 

WEM REFERENCE DO0336 5000706 04-73 
WFM REFERENCE 00339 5000706 04-73 
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2741 TERM APL REQUEST SETS FOR 
2741 TYPE TERMINALS 

43 ON D1 RELATIVE CODE BIT 
5 SIZE LIMIT SEGMENT 
?PB STMT IMPLEMENTATION OF 


ALLOW 


SYSTEM 
NOTE 


pousy 
D0301 
poyeu 
po30e 
po4ss 
D0361 
poyoy 
Dovey 
DOousO 
‘00363 
D0356 
Doves 
00513 
pouee 
DO417 
DO0437 
DO407 


DOSie. 


FUNCT ION 


LOGANALY 
CANDE 
CONTROLLER 
CANDE 

MCP 

CANDE 


DMRECOVER 


COBOL 
COBOL 
ESPOL 
AUDITDEF IN 
MCP 
SOURCENDL 
SOURCENDL 
SOURCENDL 
MCP 


ESPOL 


RJE 


eno. 


